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Building Internet And Other Native PowerPC 
Applications Has Never Been Easier Or Faster. 


SmalltalkAgents® 

SnialltalkAgents (STA) is a 
sophisticaiai rapid applica- 
ti(in ilcvdopmcni enviroiv 
ment teal on a new gen¬ 
eration of the Smalltalk lan- 
gtiagc, eaibling you to ea.sily rleliver double- 
clickable applications. 

Copland Style GUI Look & Feel 



design and pmja:t elemenLs in a “Rnder- 
like” desktop workspai^e as fluidly as you 
wotk with folders and d(x:umenLs on your 
desktop. Interactively build, wire, and inter¬ 
connect reusable coinjxtneiits and inter¬ 
faces in an integrated envitonmeni. 

GUI Design & Generation 

five "Drag and Drop" manipulation to build 
your application’s visual interface using 
components that “know” how to behave 
and autoatnfigure themselves into an envi¬ 
ronment. Create new components and/or 
wire tttgethcr existing components that t^n 



he savai a.s reusable template designs ibr 
use in other applications or containers. 



System 

MACiNTDSIt 


Creating pntfessional quality user interferes 
Is ea.sy with our comixment parts libraries. 

VisualWorkbench 

Visually manipulate all objects including 
souitc and design elements using your 
mouse and keyboard. Visually manage 



DTP Engine & Word Processor 

STA not only includes a pnigrammaftlc 
word prtxessor com[)onent and 
HyiterMcdia engine, but also a [xwerful 
roport writer that .sup|.X)rts emix'ddiiig of 
any kind of oltjects, movies, flows, and 
international text, and ivage layout. 

C/C-i-i-, Pascal Workbench 

Compile, alit, and dynamolly link CA^-i--h, 
Pascal. Rtriran, anti Assembly axle directly 
from within our STA VisualWorkbench as an 
integrated part of the Smalltalk appliation 
development pnxiess. 

Component-based Architecture 

STA components arc designed for 0[X'nDtx' 


and 01 Ji, and will give you transparent inte¬ 
gration with OiX'nDtx' and OLE when they 
baxrme available. 

Threading & Internet Tools 

STA prtjvifles powerful support for Internet 



.server as well as client tool development. 
Hre-eniplive threading, thread safe libraries 
and classes for TCP/IP prottxols are stan¬ 
dard features enabling you to quickly and 
easily deliver custom e-mail. WX/W, list-serv¬ 
er, and other dial-up/nctwork related apps. 


PowerPC Support 

S'lA provides binary portability across diffa- 



cni CPUs and 0[)craiing Systems. Design 
ap|)licatioiis ttxlay on one platform and sim¬ 
ply dcpkty on other platforms as rapred. 


Contact us about our Web Server & 
Client lixtlkit at l-}«)0-2‘Xvl339 or at 
<info(o qk.s.com> or visit our Web site 
lntp;//www.qk.s.coiU- . 



Quasar Knowledge Syslems, Inc, 
98U ParkwcMid Drive 
Bethesda, MD 20614 USA 
TeM301)530-4853 Fax: (301) 530*5712 


e Oiiasar Knowledge Systems. Inc. 1995 All nghts reserved All crthei* brand or product names are irademartcs or regtelered iradamarks of their respechve holders. 











































































































Eddy Award Winner for Bent New Developer 7bof 

- Macllmr Editors Choice Awarth, 1993 


- MacTech IMacTutor 

*"Remrcerer^B data template system is amazingr 


""A distinct iinprouemeni over E^.sEdit,'' 



- Bill Goodman^ author of Compact Pro 

'Nuke ResEdit! Resorcerer is mission-critical for us.** 

- Dave Winer^ Userland Frontier 

color pixel editors are wonderful! A work of artP 

- Dave Winzler, author of Microseeds Redux 

'*Every Macintosh developer should own a copy of Resorceren^' 

- Leonard RoserUhol, Aladdin Systems 

^Resorcerer will pay for itself many times over in saved time and effort 

- MacUser review 

**The template that disassembles PIC'Ts is awesomer 

- Bill Steinberg, author of Pyro! and PBlhols 

^'Resorcerer proved indispensible in its own creation!” 

- Doug McKenna, author ofResorcerer A 

„a wealth of tim e-saving tools. ” 

MmiUser Review^ Dee, 1992 




Version 1.2.4 



• New *cicn\ ‘ppat\ ‘crsr% ‘acur’, *pltt\ 'clut* editors 

• Powerful icon family editing (all 9 icon types) 

• Color pixel anti-aliasing, dithering, and lots more 

• Complete TICT* disassembly and reassembly 


Needs: ^ac Plus, ^ Sys 4.2,1MB 
Likes: ^ac Plus, > Sys 7*0, 2MB 
32-bit clean, AU/X compatible 


New 1.2 Features; • Resource sorting; ROM resource browsing 


• 120 template field parsing types now supported 

• New insertion & deletion template field types 

• Text-only T^ICT* resources 

• Lots of improvements throughout 


Price: $256 (decimal) 
(Educational, quantity, or 
other discounts available) 


Easier, faster, more Mac-like, and more productive than ResEdit 
Safer memory-based, not disk-file-based, design and operation 
All file information and common commands in one easy-to-use window 
Compares resource files, and even edits your data forks as well 
Visible, accumulating, editable scrap 

Searches and opens/marks/selecls resources by text content 
Makes global resource ID or typo changes easily and safely 
Builds resource files from simple Rez-like scripts 
Most editors DeRez directly to the clipboard 

All graphic editors support screen-copying or partial screen-copying 
Hot-linlcing Value Converter for editing 82 bits in a dozen formats 


Includes: 500 page manual 
60-day Money-Back Guarantee 
Domestic UPS ground shipping 


Payment: Check, PC's, or Visa/MC 


Extras (call us): 

COD, FedEx, UPS Blue/Red, 
International Shipping 


All graphic editors support screen-copying or partial screen-copying 
Hot-linlcing Value Converter for editing 82 hits in a dozen formats 
Its own 32-bit List Mgr can open and edit very large data structures 
Templates can pro- and post-process any arbitrary data structure 
Includes nearly 200 templates for common system resources 
TMPLs for Installer, MacApp, QT, Help, AppleEveni, OCE, GX, etc* 
Full integrated support for editing color dialogs and menus 
Try out balloons, ietb^s, lists and popups, even create C source code 
Integrated single-window Hex/Code Editor, with patching, searching 
Editors for cursors, versions, pictures, bundles, and lots more 
Well-designed, helpful developer tools being added all the time 
Relied on by thousands of Macintosh developers around the world 


ileEvent, OCE, GX, etc* 
iogs and menus 


Downloadable Demos/Updaters; 
AppleLink: Software Sampler 
AOL: Software Libs/Development 
CompuServe: MACDEV/Tools 
OF call us. 



P.O.Box 298 • Boulder • CO * 80306-0298 • USA 
Phone:(808)440-0707 • Fax:(303)440-0504 
AppleLinkyAmericaOnline: ItESORCERER • Internet: resorccrer@aohcom 
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By Scott T Boyd, Hditor-at-Large 

httpy/iiww, hax.corW 



Well, iLs of thi,') writing we still haven't heard anything of 
sulistance from Apple about the Macllack Top 'fen 
<http://www.machac:kx'oin/>. Sure, they released a staiemenL 
aknit the lop S items, but it was the same old “hnjxjrlanl future 
direction'’ verbiage we so often hear frtim Apple. From Apple’s 
initial response: 

"Slay tuned..,as we work out plan,s...*’ 

“Tliere’s a lot of support for this as an idea../ 

"We are investigating what would involved../ 

“We'll eon.sider validating it../ 

“We're evaluating../ 

“Any voltmteers?" 

'^It's a gml..." 

“A topic of hot discussion..."' 

":..as that hap[xns we’ll have a Ixltcr vehide...’" 

“Keep tnit’king our f>rocluct announcements,./ 

/Thanks fo Al Emm <al®i)offHTtmls,com> for pickinf> out 
the operative phrmesj 

Funny, I tiidn'i think much of the whole Top 10 Oevdoper 
Issues list idea at the conference, but Apple has convmittcxl to 
addre.ss the issues, so 1 find their lack of action disappointing. 

It simply is not common practice for Appk* to rio market 
researdi on llie needs and wants of Maeinlosh develtrpers. 
ThcTcfore, it shouldn’t Ix" much of a suqxtse iliat Apple's 
relationship with developers lacks a few items. 

It’s lime for Apple to stall delivering solutions to other 
problems tlial have lt>ng plagued developers. Let's talk about a 
few ci>nslnaitve ideas. 

Information 

At twenty seven volumes and growing, Inside Macintosh is 
starling to represeni a signilicant investment for developers, in 
terms erf lK)th time and money. Fven so, develo()ers could use 
much more. For example, as Sean Parent, PlxJtoshop engineer 
and former Blue Meanie, recently said: 

“A[)ple, what I want is a clear and precise explanation of 
every external puf^lic interface. 1 want to know whar all the 
limitations, side efllxts. Ixigs. exceptional iiehavior, invariants. 
assuini>lioas, version history, and supported jxiramcUT ranges 
arc. Inside Hic gives me aix>uL 10% of that/ 

Ome we have a g(K>d start on that, publishing die information on 
the Internet and on cheap CD’s wt)uld make a great next step. 


Overeaming Umitations 

TextEdit, the Menu Manager, the Dialog Manager, and the 
List Manager have long represented Apple’s strange affinity for- 
living with arbitrary limitations. They have all evolved Just 
alx>ut as far as tliey can, Maylx it's lime to offer up some new, 
improved toolbox managers. While it runs the risk of dying of 
not-invenied-here syndrome, would it be that far-fetched for 
Apple to license some third-pariy solutions? 

For example, imagine the benefit to developers should 
Apple decide to do away with tlie 32K TextEdit limit by taking 
Chris ‘Ibomas’ recent suggestion on SemptT.Ht, “Just pul WASTE 
in a shared library, licease it for inclusion with System 7.6 and 
Ixyond, and be deme with it." Well, write some dtKs and test it 
a bit, too. 

Bringing Apple applications into the 90’s 

Where do we start on lliis one? OpLml>nc .support in the 
lander and MVWt AppleScript supfxin for Apple control panels, 
SimpleText, MPW, and others? 

Attention 

Developers need Apple's attention. Apple needs 
developers' attention. It all comes down U> rebuilding the 
relationship between Apple and developers, but we'll save 
mme of this for later. Vkmi forget to check f>ut the wef) site for 
furtlier developments, which Apple lias )>romised by the 
Ix'ginning of (XIoIxt. 

PicTiTRE, If You Wuj,-.. 

Rarely does Apple put out advertising that we can all be prouti 
of. Sure, there have been ads that made us leel good, l>ui deep 
down we usually know that the atLs are preaching to die choir, 
Wiien was the last time we saw an advertising campaign that 
we all just fef;cwsold tx>dles of machines? I don't even know d 
the “great” 198^1 commercial sold many matJiines. 

To be fair, Apple u.sed lo liave some good ads which 
managed to deliver the "wow/ factor, I recently rhoughi that 
they’d made a et)meback. but I was rudely surjirised to find t>ut 
that iliey were acmally Compaq ads, I wah shocked. 

However, it’s all the rage lo drive $10B companies from the 
back .seat lately, so herc gtx-s. If 1 was in chaigt% Fd prolxildy try 
a few whacky tilings. First ad ampaign? Show' developers writing 
st>aware on the Mitcintosh. We doii‘l need nuas with pagers or 
corpontte execs wiiti surflMKtrds, we've got real programmers 
putting Togedier major-league prcxlutis using MacinUxsh. 

Continued on 6d 
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K:icli year, the illegal use (if software 


consumes nearly 50% of yintr jxitenlial 


rciveriLieii. Willi tlie Haines of pirsicy eating 
away at yoiirprofiLs, cm you affortl not to 
protL'Ct your software? 

Software Obtained Illegally, by region, 1993 vs. 1994 

BC 

Alrk:3/Middlo East 

S€8&,d40,r05 

392,687,055 

$3,963,527,364 

Asia 

E d.350,981.640 

Furops 



$821,992,751 

Lain America 

1,334,894,665 

USXanada 

$2,487,360,944 

3.131.455,600 

Total foT 1993: $12,940,204,124 

Total lot 1 :i;-| s $15,2T2,700,215 

Seurtc. ^ 


MacllASP*’ is widely ;iccl aimed as the world's 
most tulvanan] software protection solution 
for Macintosh com|)uters. Since 19M, 
thousands of leading Mac and Pd developers 
have used over one million Macl lASP and 
HASP keys to protect billions of dollars worth 
of software. Why? Recaiise M:icllASP's 
security, reliability, and ease-of-use led tliem 
to a sim|)le conclusion: MsicllASP is the most 
effective software protection system available. 



Tcxlay, more developers are choosing 
MiicHASP ihaji any other software protection 
method. To learn why, and to see how ettsily 
you can increase your revenues, call now to 
order your MttcHASP Developer’s Kit. 

1 - 800 - 223-4277 


ALADDIN 


The Professional's Choice 

Nortli Ataddm Software Security Inc. 

Amarica Td: m) 223 4277,212-364 S67X 

t-jut: 212-5643377 

WTO; hlljry/yw*i,b:JSp.ooiiV 

Intt Office Aladdin Knowledge Systems Ltd^ 

Ti!|: 972-3-537 5795. Vjo: 972-3 537 5?)6 
l‘>mci il; ittafkLin<itsJLiddin .cu. II 

United Aladdin Knowledge 

Kingdom Systems UK Ltd. 

rd: nmumfA Fax 01753-622262 

France Aladdin France SA 

rd: I 40859HS5, Fax: ! 4l 2! *X)56 
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I ts the highly-regiirded industry 
jitandanj, used by more developers 
than any other Macintosh develop¬ 
ment system. And now its been 
cotaJly re-enginccrcd for Power Mae. 

Introducing Symantec C-n^ 8,0 
for native Power Mac. 

Nor .since the original THINK 
C™ has anything so dramarically 
lKK>sred your producrivity. There’s a 
Visual Architect^ to generate (jUl 
code mstandy. An advanced l^rojecf 
Manager to handle the largest and 
most complex jobs. Plus native 
Power Mac tools (or radically 


The Industry Standard Just moved to A Higher Power. 
Symantec C++ 8.0 For Power Mac. 



improved performance. 

Draw ON THE 
Industry Standard. 

WieIi Syinantct C++ 8.0. you sim¬ 
ply draw the usci interface - including 
windows, dialogs, controls, icons and 
menus. Then the built-in Visual 
Architect generart^ rhe code with the 
click of a nioiLse. Now you can spend 
more time on what really sers your 
application apan - its functionality. 

A Higher Standard 
For Speed. 

Ibe new high-|XTt(>rmancc com¬ 
piler is dramatically faster than the 
previous version, so you can become 
more productive tlian ever. 

And for even more power. weVe 
added an AdvaiMxd Project Manager. It 


gives ytiu drag and drop so yoti can eas¬ 
ily add files. Named Option Sets for 
djangjngarmpkx sets of options fast, plus 
support lor even ilie largest appliaifions. 

There s also a new editor and a 
browser for modifying and navigating 
source Hies, a new debugger, an 

New! FastC 

And C++ Compilers 

for both Mac and Ihwtr Mac 

New! Visual ARCMiTEcr 

far the Power Mac 

New! Think Class Library 

2,0 for Power Mac 

New! Popup Menus 

take you ri^ to deckmtiont &i>€adtn 

Newi Debugger 

far netted projects and thared Ulmtnet 

Nhw3 Project Manager 

far multiple tarots and 

hierarchkal support 

Nkw! Split Pane Editor 

far syntax highii^tting and 

auto farmatting. 


SYMANTEC, 


i litre mental linker, THINK Class 
Library'" 2.0 and mudi more. 

A Double Standard Fdr 
68k And Power Mac. 

Symantec C++ 8,0 is the first 
native Mac/Power Mac development 
system to support C++ templates, 
nesicd classes and multiple inheri¬ 
tance, as well as ANSI C. Plus 8.0 
includes version 7.0 for 68 K support. 

This double sr.indard gives you 
everything you need for both 68K 
and Power Mac development. 


7p urdrr at d sptaai upgrade price of St 49,9%, 


cadi mm ^ 4777hxt 9if2t. 
ik mr 0 ask aboui the Spmmke 
Bevekpcfi Admntage Fmgram 
ftr premium support and rcfpt- 
kit updasn. Or visit jmrr Icicai 
iofitoatt store. 


ik, : 


c** 




1’rnf iti y. IS. fully, tor more informaTkhn In CAnaJ^ l'aII I . rut. 5SB. In I'all ?.-STy’6577. In tlmupc. call 31 -71->SI5 Ml. Symantec Ci-i, Vijtuat Arehiiec!. 

‘n tlNK t.ihl'aly arc truLlmiaflu iff SyrTLinEiT: CJurputstion. r\ll utltcr itjiflcmdtks Ati; rlii^ ptnpetty fif tttdt rtapmiivc liiiliki’i.Ci Syrtiiitii»' Ojq.H.ir3tkin. All Hght> reservcfi. 




































































































GETTING 

STARTED 


By Dave Mark, MacTech Magazine Regular Contributing Author 



TCL and Visual Architect, Part 2 


Ill liLst [iioiulfi; column, wc took a kK)k 
at Symantec's latest development 
environment, includin^^ the Symaniec 
Project Manai'er and Visual Architect. 
Following the example presented in 
Cliapter 14 of the Symantec f>+ 
(riiide, we used Visual Architect to 
generate source code Co implement the 
singlej default view named Main. We 
then returned to the Syinanlec Project 
Manager and compiled the ctide into a 
standalone application (See Figure 1). 



I, The window that appeared 
whcm imran Imi month'sFrogranr 


Tills month, we're going to add a 
second view to our program, I'hi.s 
second view will be a dbkig that allows 
yon to ty|K^ a nuinlx.T into an editable 
text field. Wlien you press the Beep 
burton, the dialog wdll beep the 
sptxified numl>er of times. 


appears, double click on ihc file name Visual Architect.rsR' to 
l>ring up Visual Architect. This is where well add the second 
view. 

• Select Neiu Uieui from tlie Uietw menu. 

• When asked to mime the new view, type BeeperDialog 
and make sure Moduli Dialog is selected from die tlieiii 
Kind: popup menu (Figure 2), iljen f>res.s the OK button, 


Please name the neui uieui 


Name; 


BeeperDialog 


Uieui Kind: | Nodal Dialog 
[ Cancel ] 


Figure 2. Naming the neu^ tieu\ 

‘File mime BeeperDialog w^ill lx: used as ihe basis for a new 
class, called CBeeperDialog. The next lime you select 
Generate from Visual Architects Symantec Project Manager 
menu, Visual Architect will generate the files CBeeperDialog.cp, 
CBceperDialog.h, x_CBeeperDialog,cp, and x_Clkx‘perDialogji. 
Firsi, we'll add a few items to tills dialog and then add a button 
to our Main view^ that brings up the dialog. 

Once you pre.ss the DK button, a view wind<?w will apix^ar 
with the name BeeperDialog. 

• Select Uieiu Info from the Bieai menir 


Addinc; a Sfx:oni> View 
Go into the Button / folder you creuLc^l 
last monili and double-click on the file 
liutton.x to launch the Symaniec Project 
Manager. When the project window 


A view info window titled Dialog Info will appear 
(Figure 3). The view info window, which looks a lot like a 
ResHdit or Kesorcerer WIND lemplal, lets you customize the 
l(K)k of ytxir new^ dialog window. 
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Figure 3^ i^^'o mndow for the BeeperDiaiog t4ew. 


texl hM, and an editable text field for entering the nunilxrr of 
lK*ef>.s. Well start with the OK and Cancel buttons. 

* Click on the button tool m the palette window. 

• Click on the BeeperDiaiog window and drag out an OK 
button. 

As you drag, keep your eye on the lower left corner of the 
window. Notice that the two coordinates listed reflect the 
upper left and lower right corners of die buLttin. 1 macle my 
button 80 pixels wide and 2Q pixels tall with an upper left 
corner of (200,^2). 


• Clii:k on the movable modal dialog icon (the second from 
die right) or type “5"' in the prcx'lD: held. 

• Click on the OK l^utlon to dismiss the dialog, 

Vour next step is to add .some items to the dialog. 

• Click on the Tools menu and drag down until the tool 
palette outline apfx.‘ars. 

When you release the mouse button, t!ie Tools palette 
window will appear (Figure 4), 'Fake a few minutes to play 
with the items in this palette. In the Lop row, you have the 
selection tool, the text icxil, and the editable text tool. The 
second row features the pushbutton tool, the radio button 
took and the ciieck l)ox tool. The third row features the 
popup menu, icon, ami PICT ukjIs. Well gel into the rest of 
itic tools in a future column. For now, try creating items 
based i>n the UhjIs in the first three rows* Click on a t<K)l. 
then click and drag in the BccfXTDialog vtew^ window. Once 
you get a feel for these ttx>ls, select die selection kk)! (the 
arrow), then click on each of the items you added and press 
the delete key. Kee(3 on deleting until the BeeperDiaiog 
window is empty again. 
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Figure 4, The Imisimlette. 

Now let's add the items that make up die fkcfxir dialog. 
Well add four iiems: an DK button, a Cancel button, a static 


• Click on the ISeeperDialog window and drag out a Cancel 
button. 

My Cancel button was also 80 pixels wide and 20 pixels 
tail, lliis time, the upper left comer was (107,42), Notice that 
VA auiomaiic'ally filled in the text OK for the first button and 
Cancel for the second button. Nice Feaiurel Ijet's change the 
OK to say Beep 

• Double-click on the DK button (or click on it and select 
Pane Info... from the Pane menu) u> bring up the Pane 
Info window. 

• Click on the triangle to the left of the class name 
CControl, revealing die CConirol data members. 

• Change contflTitle from OK to Beep and close the Pane 
Info window. 

Notice that the button's name changed from OK to Beep. 
Now let's add the static text lalxfl. 

• Click on die static text um)1 (liie big letter A) in the palette 
window. 

• Click in the fkeperDiatog window and type the text 
Number of limes to beep: 

• Click outside the static texl to stop entering text, then click 
on the static text to select it. Drag it to a salisfactory 
position in the FieeperDialog window. 

I dragged my static text so its uf)per-lert corner was at 
(23,15). You might want to use the arrow keys to move the 
static texl around the window, 4 pixels at a time. Hold down 
the command OS) key to gel the arrtjw keys to move 1 pixel at 
a time, lixperiment with the Shift and option keys wliich let 
you resize an item by 1 or 4 pixels in any of 4 directions. 

Firudly, let's add an editable text field, 

■ Click on the editable text tool (to the right of the static text 
tool) in the palette window, 

• Click on the BeeperDiaiog window and drag out an editable 
text area. 
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Take a Power Trip to a 
New Realm of Devdoping 





Powerful Tools to Take You Where You Want to Go 


Y(Xi’ve iilxRjt llw s|)ml of POwcrKrand youYQ Uiinkinj; alxjuL llie ax)! 
a()ploti()ns and ointeiit Lliis anrrt/Jng new chip will aJIcwyou to m'M. Read 
Ofi to kfarii inope about the tools tliat will tal® )uur develipnenl wlietie 
you warn fast 

Prototyping Hyperdjird" 23 provkfes a robust prototyping 
and development environment for [tmfessinnal de\'elo|}ers. It is 
also an e^-tO“Use tool for building a wide range of aislnrn soft¬ 
ware a[^[ilications for jMacintosh', from training simulaliotLs to 
infomiaiioii kiosks. And now it.k accelerated for IAmcf Macinljosh'^ 

PowerPC and 68K Compilers Metrowerks CoddVttlfrior 
(iold is the industry^ first native devebpnientermroniiM^nt for 
bulli die lYiwerRi jind 68K-based Macintosh environments. You can 
easily target die entire Macintosh installed base with code created 
asing (MIC development envimtitiffitil ninning at Ptywer Macintosh speeds. 
Cross-Piatfonn Muttitnedia Create iiuiovadve, iiUemctive muld- 
niedia lilies which will play on botli Mac OS and Windows systems. Give 
users the ability to cniise up, down and amuiid objects. They can even ziioin 
in and pick them up. No wonder QuickTinie”\T? Authoring'lbols Suite vlO 
Immn so many awards, including MacLlser Magiiane^ '*Eddy’’ for 
Rreaktlimugh Technology of the Year. 

Therek a wide variety of ilevelopment tools available through the Apple 
Developcr'ibols Catalog, Check It out, [>evelof)ing on die Macintosh pkitform 

has never been easier or faster. And now widi cross- _ 

piaifonn flexibility; itk smarter dian ever 


QuickTime VR Authoring Tools Suite v,1.0 

IMfelof) cross-i}latf(ym ?niiHinmlia products with 
Quicklime VR amimi 

m 

This suite includes complete <tociimcntalHHi for plaiuiiiig, designing, 
ph()tograi>hing and ca|)turing content. QuickTime VR uses break- 
througli comptession/decompression techniques which produce 
small file sia». And tlieres no special hardware requinal. 


How to Order 


Metrowerks CodeWarrior Gold 

A a)m(Aele development solution for OC ++ 
and Pascal /iropramming. 

m 

Runs native and cross-compiles on 68K or 
PowerPC platforms, ensuring tliat as you go 
forward on Power Miiciiilosh you also conserve your investment in 
your installed code base on 68K Macintosh and ytxir code liase 

rcmains Irackward-compatible. Lets you compile, 
link, luid debug bRK software at full native speed 
on a I’owerMac", and build PowerPC versions of 
your software on a 68K Mac. 


Tl) order caJl: 

1800 282-2732 

Arid ctsk fitr a free ibeAtifde 

Ikit^eloper 'tbois Cataii^, 

Visa, MasJnri'ajrl and AMKX aaa^pted. 


HyperCard 2.3 

A robust fmtoiyfmg and det^ehfmmii 
eminjnmmt acccll^aiedfor Pouter MucifUtksb 

$99 

Cranes with powerfiil scripting tools including 
AppleScript'Runtime built-in, a modeless script 
editor, liyiierlext support, debugging tools, new 24-bit color painting 
to(Js, Automated Button Tasks, and many otlver features. Stacks can be 

saved :is stand alone, double- 
I clickable applkxiiionsyoii may 

I i* J ^ ^ distribute without software 

I I royalty fees. 


019^ Appii) Iw rMM- the Ajipia taQo. Iltcmtitish, HaciNiKh, ItyfrtiCiiii], AptM^Tipi and OmckTinke are legistSfHl Imdoimitaii (^puler, Inc, Pnwerhbc a i trademark cA A^ipiir Con^ulffr, bic I^dwbtPC a i tnikfTwk at 

IndefFiiitloiiat Busmen htoclNitss Corpunikiii uiidu (kniH iherdnmi Oder KxpinK Ttkxs abcM no not inckidg liid shitMiuit)' Picm iod itroduett ara subje^ 10 changn vdihntii nmiicc To p&ix lOFiieni trom Oshada qH 1 -d(XH6SV-0Q23; 

autskio CMiadQ ail 1 716 8? 1 6555 w tia inquinea lo I'/te-B/i-eali. htioss 




















Mine likid and upper left corner of (205,13) ^ind a lower 
right of (280,29), Once your items are in place^ resize the 
dialog view so it comfonably encloses the dialog items. To do 
that, click on the handle in the lower-right corner of the grey 
rectangle eml>edded in the lieeperUialog window. Drag the 
lumdle to its new i^jositicm. 1 dragged mine to (293,75), llie 
finished Beeper dialog is show^n in Figure 5. 



Rgu?'c 5 . Jht*JmiKbed dkikjg udth the Beep huUon 

sciedcci. 


If yon like^ yon can Try the dialog out by selecting Try 
Out from the Uieiu menu. Click on one of the buttons or 
select Close from the File menu to close the Try Out window 
once you are done admiring yotir handiwork. 

Our next task is lo tell VA ihai our edit text field is 
de.signed to fiold only integers (as o[>posed ttj any old text). 

• Click on rile editable text field, 

• Select Class from the Pane menu, ihen select 
CIntegerTeKt from the submenu that appears. 

Next, we need to define a new command that will get .sent 
when the Beep button is clicked. Right now tlie Beep 
butttin's command is set to cmdOK, lb see that, douf^ie-ciick 
on the Beep button to bring up the Pane Info window, then 
dick on the CButton triangle. Take a look at the Comtnand 
popup menu. IF you click on it, you’ll Ond a whole bunch of 
commands, all of them built into the TCL. Since there is no 
Beep coniiTiand, we'll need to define it ourselves, then set the 
Beep button to send it when clicked. 


This tells VA what you want done in response to this 
command. You could do nothing, you could a,sk VA to call a 
function, or you could open another view, in our case, weVe 
asked VA Lo call a Crieefx:rDialog member function. We'll gel 
to that function in a bit. 

[sfofice that VA automartcaily generated the command 
number 512. This is not particularly important. Youll use the 
constant cmdBeep iastead of 512, so there’s no reason to 
memorize your command numbers, 

* Click on the OK button to dismis.s the Commands dialog. 

As you’ve probably guessed, your next step is to associate 
the cmdBeep command with the Beep f^utton. 

* Double-dick on the Beep button to bring up tfie Pane Info 
window. 

* Click on the triangle to the left of the class CButton, 
revealing the Co mm and p<)pup mmi. 

* Select cmdBeep from the Command popup (Figure 6). 

* Close the Pane Info window^ 



I Identifier: 
Left 


1200 


|80 

J 


^ Height: [zD | 


caution 

Commond: | cmdBeep" 

^ CControl 
^ CPanc 
t> CVIew 


O 




6. The Pune fnfo window asKockiled wilt the Beep 
indton . Notice ihai ibe Com ma ud popup 
has been i>cn /o emdikep. 


You may have noticed that the Beep biilton no longer has 
tile bold, rtRinded rectangle around it, specifying it as the 
default button, the bunon pressed when the user liits return. 
This changed because VA siiedfies the emdOK command as the 
default. Let's hx that. 


• Ckxse I he Beep Pane Info wan clow, if you opened it to lotjk 
at the Command popup. 

• With the BeeperDiaiog %vjndow fremtmost, select 
Commands... from the Edit meniL 

• When the Ct>mmands window appears, select Neii; 
Command froni the Edit meruL 

• Type cmdBeep in the uppermost editable text field. 

• Select CBeeperOialog from the In Class: p<ipup menu. 
This tells VA which class this command Iselongs to, 

• Select Call from the Bo: popup menu. 


* Select Set Default Command from the Bieui menu 

• Select cmdBeep from the Command po[>up menu, then 
press OK, 

Notice I hat the hokf rounded rectangle is hack around the 
Beep button (Figure 7). 
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Announcing 


MICROCUARD# 

f 

Why so many developers are switching to 
MicroGuard copy protection 


• MicroGuard is committed to uncompromising 
technological superiority 


• MicroGuard has now surpassed its own 

technological lead, actually improving on the best 



"Tethnokjgy <)i its peak" is our cummiinicnt m you. 'Ihai w why w^ have 
batughl ym MirroGuard Plus™.Aod, MicmCuanJ RusIs lOO^fc 
backwards romparihic with MicrtiGuanri. This nteans MitmCuml 
and MiLitjCuanl Plus on be um\ inteirhangeabfy. 

Just as we promised! 


MicroGuard offers you the 
most sophisticated network 
protection 

Our network piotecitun, MieroGuard 
Is so superior^ we had id hire an Apple t id work 
enginm* to otraite our specifications. 


MicroGuard is the only key 
developed by Mac 
developers, and is the first 
and only 100% ADB savvy key 


MEL’iTjGuaiii Plus is es-crything Mjrn>Ciuanl is, plus 40-bit encryption, two 
additional passwords, 64-Bit Array, 52-byic public area, i5% size redumon, 
cnhanceti rnunier and more. In adtiiiion, MtcioCuaitl Plus ofFcrs two new' 
uiiHttcs: QtiickGuard™ and KasyGuard ™ aOowyuu loptotcd yDur 

applica lions wiihoul louchiiig your 
soEjrcecorie. The only feature that 
is n(g plas is the price.:-) 


• MicroGuard is the best 
selling Macintosh key in 
the world 

MicroGuard sells more Macimosli 
copyf mtection keys than anyone ebe 
in the world! 


• MicroGuard delivers 
developer support 
within 24 hours 


We have been developing Mac appiianions as a seed development binise 
since 1984. We are not a PC protmton company that Im eomc to you 
with a Mae pnxiuct. MicnjCjuard is fully ADH savvy and offers atendecl 
addressittg, Unlike utlicr jrnoicction devices, MicnXtuard never clashes 
with other keys. Only MieroGuaid offers diis level of sophistication. 


We will answer any inquiry you have within 24-houni. We aLst^ have a fully Med 
AppleLink bulletin board which cfjntainsall im libraries, teili notes, Q&A and 
ncitily everything youl ever need! 




For more infonnation ariil lo order u Dei’etopeFs^ KU or io receit^e a free CD ROM ahoul MkmCimrd, 
please conlaci us ah 


MicroGuard USA: Td:(.W) 320-1628 • Fax: (303) 320-1599 • AppleLink: M.CUARD ; 

International: Tel:(972)3 558-2345 • Fax:(972)3 558-2344 • AppleLink:MICROGUARD MaCuo 



Pirate l^ustcrs 

















Figure 7, Tj&t? BeeperDialog mndow, 
once cmdBeep is set as the default commattd. 


Wtf ane alm<xsi done! Now we have lo add a hurron to ihe 

Main view that brings up the Beeper dbilog* 

• Close the ReeperDialog view window* 

• Double-click on Main in the view list window to firing up 
the Main view window. 

• Click on the grow lx)X in the lower left comer of the Main 
view windcjw and drag down alxiut 50 pixels. 

• Click on the handle in the lower right comer tjf die grey 
hounding rectangle inside the window and drag it down 
about 50 pixels. 

You’ve jysi resized the Main view to lx alKuit 50 pixels 

taller^ making rotini Torn new pushbullon. 

• Click on the pushbutton tool (under the arrow) in die 
palette window. 

• Click in the Main view window^ and drag out a new button 
below the PICT. 

• Before you click off the button, type the word Beeper... 
1he button will now Ixar the name Beeper.... 

• Double-click on the Beeper.*, button, bringing up the 
button's Pane Info window. 

• Click on the triangle next to the class name CHutton to 
reveal the CBuiton data incmhers. 

• Cluxise Other... from the top of the Command popup 
menu. 

• When the Commands dialog appears, choose Neiu 
Command from the Edit menu. 

• Rater llie command name c md B e e p e rD i a log. 

• Choose CMain from the In Class: popup menu to let VA 
know you want the new' command associated with the 
CMain class. 

• Choose Open from the Do: popup menu. 

• Chfx>se CBeeperDialog from the Uieui: popup menu. 

We've just told VA that we want this new command 

(cmdBeeperDiaiog) to open the CBeeperDialog view (Jiee 

Figure 8), 


Comraanils 


Lnidflpt^pprDiiitDg 


Number* S13 

rficlians:--- 

In Clots: [ CHain V) 

Do: I Open 

Uieiu: [ CBeeperDialog ^ 

[ Concel) 

r~^ 


Figure 8, We Commands windotv for the new 
cmdBeeperDiaiog command. 

• Click on die OK button. 

Now weVe told VA to as^sucialc this command with the 
Beeper... button we just created. 

• Close tlie button's Pane Info window to return to the Main 
view wintlow (Figure 9). 



Figure 9. My Main meu* with my nete Beeper... button. 

If you like, select Try Out from the Uieni menu and take 
your new^ version of Main f<ir a s[iin. Note that wc haven't put 
the code in place that gets called when the Beeper... button 
is pressed, but the scrollbars should work and the button 
should highlight when clicked. 

Our next step is to ask VA to regenemte our source code, 
reflet ting the new panes and commands weVe ik^fined. 

• Select Generate... from the Symantec Project Manager 
menu (diamond shaped menu to the right of the 

LUiiidouis menu). 


tmillllal rspuce 

imiUlbDul 

cindfllignC enter 

cmiiniignLeft 

tmdHIignRighl 

fmdBeep 


f md Beeper [ita fog 


cmdBotd 


tmdCunrel 


cmdilenr 

_ 


'0 
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■ when proniplcd to .sjive your changes, dick OK. 

VA will update your existing ctxie base. If you selected 
Generate filL.*, VA would have replaced your existing 
code l)ase. Fte sure you understand this differencd 

Adding the New Code 

Our last step is to add a few lines of code to bring all our new 
interface elements together. 

• Return to the Symantec Project Manager. 

• In the projeti window, dick on the triangle to the left of the 
folder lulx'led St>urce. Skip this step if the Source folder 
was already opened, 

• Doulite dic4 on the Hie name XBeeperDialog.cp”. 

• Add this code to the end of CBeeperDialog.cp: 

void CBeepe rt> fa 1 og; j aoCnidBeep () 

[ 

long 

n ” fBeL*perBlaiog_Editl5->RfiTTntValae()' 
for ( long 1^: i<n: iH I 
SysBeepl 20 )j 
I 

This code references the data member 
fBeepernialog_Editl5. When VA generates your code, it iriakes 
up a consiani for each of your dialog items. You can Imcl these 
definitions in the file BeeperDialogIterns.h. Here's the 
cf)nstanis that were generated for my version of Beeper: 

vnuiD 

i 

BeeperDla tog^.B<:ig i ri_. 
kB^epprnialog_ttuLiil2 = 1. 
kBpppRrniolog_ttutnl2rD ^ 
kBcoperaiiilog_Butnn 2, 
kBecperDialog^ButnlllD - 2050L, 
kBeeperDialogStat14 ^ 3, 
kBeeperDialog St.ar|4Tn = 20blL, 
kBeeperBialog Si^rt? = 4, 
kBeepei:Dia1og_5lHLl/iD = 2053L, 
kBeepprDl^Iog^Kditl^ * 5, 
kBppporDlploa-Edin^ID - 2052L» 

^ Beppcrl)iiilog^Epd_ 

The memiier function GeLintValue () retrieves the 
value from the field that calls it (in this case, the editable text 
field), translates the value into an integer, and returns it. The 
kK)p uses Lliis value to beep the specified na[Tilx.^r of times. 

• Go to the top of the file and remove the comment 
characters {//) at the iK^ginning of the line: 

//jfineliide ^AppCoromands*h” 

You'll need to do this last step whenever your view 
includes at least 1 command. 

• Close CBeeperDialog.cp. 

• Open the file CBeeperDialogJi and add this member 
function declaration to the public section of tfie 
CBeeperDialog class: 

void DoCmdBptfpO: 


Tltafs it! When you run the program, the Main view should 
appear, featuring a l>rand new button (Figure 10). 



figure 1(1 The Main pieu^, with ihe Beeper..- hution pressed. 


Press the Beeper... button, 'fhe Beeper Dialog will 
apjx:ar. Type a num1>er in i!ie text field and press the Beep 
button. Happy? 


..BeepeiHialog 

Number of times to beep; 

5 

1 

Cancel ] 



Figure 17. Pressing the Beep builon. 


Till Next Month,.. 

Next montli, we’ll go back to Power Plant. I just got my copy of 
CW7, anti Vm anxious to dig into it. Hf>pe you got your 
upgrades, itK>, See you next month,,. 



Visit MacTech Magazine’s Web site! 
http://www.mactech.com 
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Developer Central 

Sponsored by 



and 


f&r Macinimb 
l^ro/iritmmers & Devektpers 



MAGAZINE 


Macworld Expo/San Francisco • January 9 -12,1996 
Moscone Convention Center 


Come to the Center of the Universe! 

(The Macintosh development universe.) 


If you are developing custom applications, custom 
solutions, multimedia, or engineering solutions for the 
Macintosh, then you need to visit Developer Central. 
Here — all in one place — you will see the latest tools for 
Macintosh and Newton development. In addition, Apple 
Computer will be available with information on its 
training and programs to support developers. 


If you want to jump-start your knowledge of 
Macintosh development or come up to .speed on a new 
technology or tool, then visit the Developer Central 
Theater, where representatives of Apple’s Developer 
University and others will be presenting the inside scoop 
on Macintosh development. 


At Developer Central, you can,_,^ 

• Talk to representatives and demo products from a number of Third Party Vendors 
• Attend sessions in the Developer Central Theater 
• Get the best deals on tools from APDA and MacTech 

So, no matter if you are corporate developer putting together a departmental system, 

use the Macintosh in science, 

or are aiming to have the next great Macintosh application or multimedia tide, 
you will find what you need at Developer Central. 

Developer Central 

Th e Source for Macintosh Development 

Sponsored by Apple Computer, Inc. and MacTeth Magazine 


A|)j>]c and ihe Apple kigo arc irMlcnmks of A|yple Q jonpuier. Inc. MacTcrh and iMaga/inc are trademarks f>f Xplain (iorisDraiion 

Developer Q^ntral anti Virtual Dcvel(jf)eT Central are trademarks of Xpbin Corporaikin and Apple a>mptJier, Ine. 













PROGRAMMER'S 

CHALLEIUGE 


Hy Hoh Boomim, We^tford, MassachitseUs 



Encuwing Bounds 

' ChallL'n^c lliis month is hasixl on a .sug^csjitjn hy Mike 
Scan I in, who remains a fan of the column. (We're still wailing 
for Mike's first Challenge entry, however) Hie prt)blem Ls to 
write a routine that will return a rectangle eneloosing all non¬ 
white pixels in a selected area of an image, litis code might 
l>e iistdiil in a drawing ur [tainting pntjgntm, where the user 
wtJLild ix: allowed to select a subset tjf the image by clicking 
and dragging, and the softw^are would select all r)f tlie 
elements of the image conlainetl Within that selection. Tlie 
]')rototype of thi' code you wall write Is: 

void KnrlnjjiogBoundst 

P i xMiipllaiidie pm, r hantllr Ui PixM:tp tuiiuiiiing inugc 7 

Re L‘ L 1 ec 110 n. T substi t>f image lo etideise 7 

Re c t ■ e n cl os i ngR^ c r /* enelosiiij^ reel ret um value 7 

): 

Yonr ccxle should exaiiiine all of the pixels within llte 
selection RXTangle of the PixMap and return the smallest 
rectangle cuniainiog all of the non-whiie pixels. Pixels 
outside the EJelectlon rectangle should be ignored. The 
bounds rectangle of the PixMa[) will be no larger than 2048 
pixels in each dimension, the baseAddr pointer w'Ql Ix^ 
longw'ord aligned, and rowRyteji will Ix" a tiiultiple of 4. 
You should deal w ith pixclSize values of 1, 8, or 32, with 
values of 8 anti 32 Ixiog weighted most lieavily in measuring 
pt^rformance. For l^txMaps with indexed pixels 
(cmpCoun L~l), the co]t>r lal>le will coniain wliile as tlie 
first table eniry (as ail gtKKl color tables are supposed to). 
For PixMaps with dirtict pixels, the unused (alpha) hits of 
each pixel will Ix zero. 

You may use either the Metniwerks or the vSymantcc 
compilers for this native PowerPC Challenge. If you have any 


<Hicstions, or w<.>uld like some lest data ibr your ctxie, please 
send me e-mail at one of the Programmer's Challenge 
addresses, or directly to bcK)nsEra@ultrunct.coin. 

IWo Months Ago Winner 

Ckmgrauilations to Erie Lengyel (iilacksbnrg, VA) for submitting 
rhe fastest and sniallesr entry to the Keversibie Scrambling 
Algorilhm Ch;ilienge. Despite an unfortunate delay in publication 
of the magazine that left participants wiiii less time than usual to 
complete the Clmllenge, three of the four entries I received by 
the extended deadline worked tTornecily, at least in [ran. 

You might recall that the Challenge was to write code that 
would raise a large integer message to a power and ccanpute 
the remainder mtKltilo another large integer. The name of the 
Challenge comes From the fad that this technique is reversible, 
given [)roperly chosen integers. Eric is a graduate student in 
Mathematics at Virginia Tech, and he ttxik advanutge of a highly 
optimized multiple precision integer arithmetic library that he 
had writum as pan of a number theory project involving the 
faclorizaition of very large numlxrs. 

Kach of tlie working entries converted the BigNum 
representation provided in the problem into one that right- 
jtJsrified nunilxTs into a lixed-lengilj cktia stnicture. While this 
impose.s a restriction on rhe maximum size integer that fht* ctxJe 
can handle, this assumption was permitted by the problem 
staiemeni. In Eric’s code, the restrictsm is controlled hy a 
single #dcf ine statement 

Erie uses a binary exponentiatkm algorithm to raise the 
message to the specified power, and takes advantage of facts 
from numIxT theory that allow' the remainder to be computed at 
each step of the exponentiation. The time to perform the 
cxponentiaTitin Is therelbrc proportional to the logarithm of the 



Here's ht)W it works: mimih we present a new' 

prognnnming eliailenae liere. First, write .sotne eotle thiii ^jIvcs 
tJie thallenat'. Seeemd, optiml7,e your crjde (a lot). Tlien^ sulimit your 
solutitiii to MinTeeli mag:»:sir>e We elnsose winru-r liascd on i'4>de 
eorrtxtness, speeil, sizt'. :md elej^intx' (in lltul onlef <jf importsru'e) as well us 
tile ;iul3mLs,sl<>n fiule. tn the event of multiple of|ually tte,sinible solutions, well 
eiioose one winner (with lionunil>le mention, hui no pri^e, given to the 
runner trp). Ilie prize lor eudi riKmtirs liesf solutkm b a $10(> oedii in the 
MaeTi^ch Mail Order Sttire und a limited-edition, “'('he Winner! .Ma*‘Tt:eK 
FrogramiTKTS Challenge’' T-shirt (not available in stoa^ anyw'here). 

L'ldejis suierl otiterwisrr irv tiv prolilem sciienienc llie Nkiwing rules apply: 
AU solutioris must bt‘ in ANSI erjmpaiilile C Uise only linin' (' ititk:. We dlsqitalify 
eiurk.^ wtlli any asst‘ml>ly in tht-m Cexeqa for ehjtllenges .six:eU:ic.nily staled 
ollierwise). YfMi nray oill any Maeintosli 1’(xillx>x routine (e.g.. it doesi'l matter it 
you LLse NewPtr ins’ieatl of inulkx’). We lest intrk's with uKUpik'r OfiLions set to 
tiLsalile msi' (fin 68tk0 code) and to enaNe all avuilalik' sjjeed ofXimizations. 
ITte it^mpikT to lx.' used anti tlx* fargo insimaion set tfiHOxti nr i^owtriO will tx* 


staled in tlie pnitik^m. I jmit your code to 60 charm.1er^ per liiK^ 
tiiis lielps witti e-mjiil gateways urxJ ixvge lavtxiL 
W'e pul>lbih the solutii>n and winners for this month's Frogmnnner's 
(Jiullengi' iwfi months Liter. All suljnusi^xns mnsi lie receit^^d hy die lOiii 
day of tlx' month printed iwi tlx* frtmt covtn of this i.^isue. 

Villi can get a liead stun on the t:h:illi;nge hy reading tlie online version. 
We fxxst it to tlie online .serviixis al rht' same rime rliat we post soutte axle. 
We make every effort to have it online no later than when the magazines are 
mailed, kit we're unalile to guarantee tliat it will lie online hy any given date 
Mark soluiion.s *Ann: Pn>gramnxn''s Cliallenge Solntton’ and send it by 
e-mail to ont: of the Progranimer’s Cliallenge addresses in the ‘I low lo 
C^mimtinknie With Us" fie(.tion on pa|^ 2 of this is.sue- Indnde the solution, 
all relaitxJ files, and your soniad info. 

MaeTeeh Magazine reserves thc‘ right to puhltsh any soJuLkm enicrt'd in 
the Prognimrner’s (ihallenge. Ant hors grant MacTecii Mag^tzine the extiusivc 
right to puhlLsti enurie.s w'irhom limitation U|Kin suiitnl.ssi{>n r:if eueh entry. 
Authors retain eopyrighes for the eodc 
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Project 


J ointSolutions Marketing is now creating 
exciting World Wide Web pages for various 
clients, including Apple Computer, Inc. 

We can also assist you with all aspects of data¬ 
base publishing and interface design. 

Call for the W'cb addres.ses of our latest projects. 

Don’t miss this opportunity to reach your 
target audience. Call todayl 


I 

Cet Net iVfse... NOW! 


• IVeb Page Design 

na acreeti Design 

• interface Design 

• Database Publishing 
Management 


loIntSolutions Marketing 

408/338-6471 
408/338-6475 (fax) 
j$olver®aol.com (e-mail) 


JOI^g 


exponent, tide's multiplication and division routines use the 
68020 s capability to compute the 64-bit product of two 
longwords and to divide a 64-bii dividend by a longword, 'Ihe 
niuitipliotion, division, exfK>ncntiatioii, and comjwe routines 
in Eric's cocie arc gcnenil purpose and couitl lx.‘ used in any 
68K application that needs iargtt tntt^gers. 

Honorable mention goes to Ernst Municr, who submitted 
an entry in pune C that was actually the fastest ctjde for the 
short modulus test cases. Llnfonunateiy; his entry did not 
[iRKiuee correct results for the longer mcxluli. 

Here are the Limes and code sizes for the entries that 
worked correctly (or partially correctly). Exeeulion lime is 
presented for two specifit^ terst cases, with modulus lengths of 
22 and 88 b^les, respectively^ as well as the total time for all of 
the test c‘ase.s [ ran. Clases that produced incorrect results are 
indicated with an asterisk. Numbers in parens after a person’s 
name indicate that person's cumulative point total for all 
prevknis Challenges, not including this one. 

Name time! tinic2 Total time code data 

{22 bytes) (88 bytes) 

Erirlengyd -17 463 20S5 1190 0 

Xan Gregg (51) 35 967 3175 1558 0 

Ernst MuntLtfC mry) (90) 17 ' " 4266 117H8 


Top 20 ContivSTAnts of Aij. Time 
Here are tlic Top 20 Contestants for the Programmer's 
Challenges to date. The nuinbens below include points 
awarded for this month's entrants. (Note: lies are listed 
alphafxMically by last name - there are tnore than 20 people 
listed this month btx'ause of ties.) 


Rank 

Name 

Point*. 

1. 

iName deleiedl 

176 

2. 

Mttnter, Ernst 

9() 

3. 

Karsh, Hill 

78 

4. 

Stenger, Allen 

65 

5. 

Gregg, Xan 

61 

6. 

Uirsson, Gustav 

60 

7. 

Riha, Stepan 

51 

8. 

GtXfhtH, James 

49 

9. 

Ncj>sund, Ronald 

47 

10. 

Cults, Kevin 

46 

11. 

Mallett, Jeff 

44 

12. 

Kasparian, RafTi 

42 

13. 

Vineyard, Jeremy 

42 

14. 

Darrah, Dave 

31 

15. 

l^ndry, Larry 

29 

16. 

Elweitowski, Tom 

24 
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17. 

Lee, Johnny 

22 

18. 

Noll, RolTert 

22 

19. 

Anderson, Tnoy 

20 

20. 

Bcilh, Gary 

20 

21. 

Buigoyne, Nick 

20 

22. 

Galway, Will 

20 

2.5. 

Israel.son, Steve 

20 

24. 

Landwelxr, Greg 

20 

25. 

Lengyel, Eric 

20 

26. 

Pinkerton^ Tom 

20 


There are three ways to earn points: (1) scoring in the top 

5 of any ChiiJlcnge, (2) Ixnng the first person to find a hug in a 
puhlished winning solution or, (3) being the first person to 
suggest a Challenge that I use. The points you can win arc: 


1st place 

20 points 


2nd place 

10 points 


3rd place 

7 points 


4th place 

4 points 


5ili place 

2 fXHni.s 


finding bug 

2 points 


sugge.sting Challenge 

2 points 


I Icru IS Eric's winning solution: 


PuWl-RAjNDRl-MAlNDliK.C: 

Copyrigiii © 199^ Hric Ltfngyi^l 

r 

I call my fixctl Irngth niimhtTS ’^RigFixt'd" ami imnslaic from lo IWgKixial‘s in 

rtic PowiTAndRanaimltT rou(iJic. nu*sf are tJii: nsiScinbly language rmiUnci which nrc 
ibc gurs of my program: 

(1) FowcfMod - mists a otimhtr to a power and reduces it by a modulus, h uses a fast 
binar)' exponentiation algorithm, reducing by dit modulus at each stq>. 

C2) Multiply - multiplies 2 BigMum's together, 

0) MultQ - mutliplies a HigKum by a long int. 

(4) fyivhk - divkies one BigNimi by another ami supplks the quotient ami remainder. 

(5) tompare - determines ihe tifukting trf 2 BigNum's. 

ScMue of die bops have been expanded to make more tiBeieirt use of iJic infarueiion 
Cliche. 

V 

^define NumSlze 17. 

lypedef struct BigNum 

( 

short nujnDig: 

unsigned char *dlg; 

1 BigNun: 

r.ypedef struct BlgFlxcd 
f 

unsigned char dlglNuiiiSiae*4h 

I BlglTlaed: 

/* We need 72 longs Inrcause the division routine needs the most significant kirtgword 
to be zcfo and the speed optimization requires that NumSize be a multiple of ftmr. 7 

void PowcrAndRoiininderCBlgMum 'msg* blgNun *eKp, BigNuo *ii, 
BlgNum *res); 

void PowerKod{BigFlxed ’msg* BigFixed ‘exp. BigFlxed 'n. 
BigFixed * res): 

void Hultiply(BigFixed ‘srd. BigFlxed *src2, BlgFixed ’dst): 
void MultQ(BigFixed *stcl. long src2* BigFlxed 'dst); 


void Dlvide(BigFixed *end. BigFlxed •sor* DlgFixed *dst); 
short Compare(BlgFixed •srcl. BlgFixed ‘srezT; 


Pow'CT* AndReniai ndtT 

void PovfcrAndRema 1 rtder (BlgMum •tisg,, FtlgNum *cxp, BigHuiE "n^ 
RigNum 'res) 

I 

short a. b. numDiglts^ 

BigFixed atagO, nxpO. nO. rnsQ: 

for {a =0; a i NuniSizp*4j nf+) 

I 

b = NuaiSlsso '4 msg >nuailUgr 
if {a < b} msgO.diglal ^ 0; 
else nsgO.diglaJ = nisg->dlgLfl ' bj: 
b - NuniSize*4 - exp->nuQiDig: 

If (a < b) expO.digfa] ^ 0: 

fllsfi exp0.dig[fl] "f^xp->dig[n ■ b] j 

b = NumSiKe‘4 n >[uimlHg; 

if (ii < b) u0*dlg[a] - D: 

else nD.[iig[aJ n->dig[a b|; 

1 

PowerModC&nsgO, &expQ> SnO^ &rea0): 
a “ Oj 

Mhile (resD-digla] ^ 0) aHj 
nujnbiglts “ res->rujnibig ' Nu!?iSixe*4 
for tb - Or b < riumDigits; b^^") 
res Migjb] “ resO.dig[a+tJ ; 


FtiwerMcxl 

void PowerHod(BigFixed ‘rang, filgFtxod *exp* BigFUed *n, 
BigFixed ‘res) 

I 

BigFixed ac c « scrap: 
asm 


LFA 

nnr;* AO 

#NumSli{DM 2 . DO 

; Start with one in 

MOVEO 

; accumulaior 

@Z GLICL 

(Ati) + 


(JLR^L 

(AO 3 + 


€LR*L 

(AO 3 + 


CLR.L 

(A0) + 


DBF 

DO. 


CLR.L 

(AO)t 


ntR J, 

(AO) 


CLR*L 

(AO)-^ 


HOVKQ 

#1. m 


MOVE.L 

DO, (AO) 


H0VEA,t 

exp, AO 

; Put adUniiof 
: expuniuit iti AO 

CLR.W 

m 

; 1)2 holds p<isiik)n 
; in exponent 

TSTJ* 

OOtAO, n7,W*4) 

; Fiml Rrst kingwtml 
; orc'xpfinm 

BNE 


, w hich is not zem 

CHFI.W 

BEQ 

#NumSize-l* D2 
§5 

//G D2 

. If entire exponent 
; is zertj, leave 

ADDQ.W 


BRA 

m 


^4 CLR.L 

D] 

; D1 holds the hit * 

PEA 


; S£|uafr aecumiilator 

PEA 

ucc 

PEA 

acc 


JBR 

Multiply 


ADDA.W 

h2, A7 


MOVE.L 

n* -(A7) 

; Ckmiparr aceumulator 

PEA 

ar.f: 

; to modulus 

JSR 

Compu re 


Aniig,w 

#8. A7 


TST.B 

m 


BHl 

m 

* If it's te, skip 
; fvduciion 

PEA 

secap 

; Reduce acctiinula{<»r 
: modukj “n"* 

HfiVEJ. 

n. -fA7) 

; Quotient not nc-cxled, 

PEA 

acr. 

; sinre in “srmp^ 

JSU 

Divide 
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ADDA.W 

fu. A7 


ex MOVE.W 

Di, topStop 


@7 BFTST 

OOfAO, D2.W‘4] tDl:lJ ; Ta^ 3 bit in current 

m CLR-L 

00(A2. D1.W4) 

Clear leading kingi^^ords 



; longword of expf^nent 

DBF 

Dl. @B 

of partial pmdtict 

BKQ 

9\ 

; If srjero, skip multiply 

ADDA.W 

INubSIxo * 4. A4 

Atkl sire 

PEA 

acc 

; IVtulti ply :tccii muLitor 

CLH.L 

D2 

D2 is carry rtglsicr 

PEA 

acc 

; by base 

MDVK.L 

00(A3, D4,W*4), D/ 

Get longword fnim 

MOVE.L 

rosgp (A/) 




boiium number 

JSR 

Kuitipiy 


WOVEQ 

#NumSize * 1. D3 

U3 iMJKlii ptisiiiiin 

ADBA.W 

#12, A7 




in pniduct 

MOVE.L 

n, -(A?) 

; <k)mparc acuimulaiur 

@1 MOVE.L 

D7, D5 

lofiRWurd to D3 

PEA 

acc 

; to modulus 

WDJLL 

’(A4), mim 

Da Mbit multiply 

JSR 

Compa r(> 


ADDJ. 

D2, m 

Add carry to low 

ADDQ*W 

#8. A7 




longwofd of product 

TST.B 

DO 


CLR.L 

DZ 

Use D2 as dummy to 

CRi 

m 

; [fit's less, skip 



extend carry 



; reducliott 

ADDX.L 

D2, D6 

Add zero to liigli 

PEA 

scrap 

: Reduce modulo “n" 



kmgvv^oTtl with carry' 

MOVE.L 

n. -(A?) 


HOVE.L 

D6, D2 

Anyihing in high 

PEA 

arc 




longword gets curried 

JSR 

Divide 


MOVE.L 

m. 00{A2. 03.W*4) 

Store low longword in 

ABDA.W 

#U, hi 




part ial product 

§1 ADDQ.W 

#1. B1 

, Increase bh number 

SUflQ.W 

#1, D3 

Loop Lhiuugh all 

CHPI,B 

#12, D1 


CHP.W 

topStop. D3 

lungwunls in numlxT 

BLT 

@2 

; lf <32, liKjp 

BGE 

@1 


ADDQ.W 

#1. D2 

; Incrtase kinj*W(iid ^ 

HOVEA.L 

A2, AO 

Now add partial product 

CMFI.W 

#NyinSfzf!, D2 




to accumulator 

BLT 


, If < number size, loop 

MGVE.L 

1)4. DO 

Qilailatc correct 

9b LEA 

acc, AO 

; Copy ncc to "res’' 



IHisition in product 

mvEk.L 

res, A1 


LEA 

acc, Al 

Cki accumulator's addr 

mvm 

#WuniSize/4' t. 

DO 

ADDQ.W 

#1. DO 


93 HOVE.L 

(A0)+, (Al)+ 


ADDA.W 

llfNumSiie • AO 


MOVE.L 

(A0)+, (Al)l 


LSL.W 

#2. DO 


MOVE. I* 

(A0)+, (Al)t 


ADDA.W 

no. Al 


MOVE,L 

(A0)+. (AI)+ 


HOVE.W 

DA. Dl 


DBF 

DO. @3 


MOVE.L 

(Al). DO 

(.iei longword of product 

1 



SUDQ 

#1. Dl 


1 



ADD,L 

■(AO), DO 

Add longword of 




MOVE.L 

DO. (Al) 

partial product 



Miiltinfv 

TBT, W 

□ ! 

If no rofirc liingwords, 



I1IIIII >1 

BHI 

m 

then hmnch 

r Mnlripty srcl by src2 ami put priKlm t in dst 7 

93 ADDX.L 

(AO). (Al) 

Add next longwtird 




DBF 

Dl, @0 

IjtKip ilirougl) 

void Multiply(BigEiited *srcl. Bigfixed *Eirc2* BigFixed ‘dst) 



entire product 

i 



e2 SllBQ,W 

h, DA 

Loop and do next 

short 

topStop, botStop: 

CMP.W 

botStnp. DA 

longword of bottom » 

BigFixed 

acc, 1ine; 


RCE 

ah 





#8 LEA 

acc , AO 

( kipy prodix t to ‘dst’ 

EiEin 



MOVia.L 

tlist. Al 


1 



MOVEQ 

#NunSize/A-l. DO 


HOVEM.L 

no-D7/AO-AA* ‘ 

(A/) 

95 mn.i 

(A0)+. (Al)+ 


LEA 

acc, AO 

; Clear ^eeunuilatijr 

MOVE.L 

(A0)+. (Al)+ 


MOVEQ 

fNumSiza/4-1. 

DO 

MOVR.L 

(ACl)l. (Al)l 


9Z CLR.L 

CA0)f 


MOVE.L 

(Atl)l. (A1)t 


CLR.L 

(AO)^ 


DBF 

no. ei 


CLR.L 

(A0}+ 


MOVEM,L 

(A7)+. DO D//A0 AA 


CLR.L 

{AO) + 


1 



DBF 

DO. 


1 



LEA 

line. A2 

. “line" holds partial 






; piXHllKtN 




MOVEA.L 

srcl, A3 

; Move bottom numlx^r’s 

r Multiply srel by srei and put prtKiuct m dst V 

CLR.W 

D1 

; address into A5 




m TST,L 

0n[A3. n[.w*4) 

. Fiml Tim non /ere 

void MultOtHlgFixcd *srcl* long 

erc2, BigFlxed *dat 

BNK 

@7 

, k mgwt}rd { if hi itts im # 

[ 



Anuq.w 

#1. D1 


BigKixed 

pl'Ol 


CHPl.W 

#NuntSixe. Dl 

, If bottom mtmIxTO. 




BEQ 

@8 

: ^0 u> end 

asm 



BRA 

@6 

; liHjp 

1 



§7 MOVE.W 

Dl, hotStop 


mWEM,L 

nQ-D7/AO/AI. (A7) 


HDVEQ 

#NuiixSl7.e 1. 

n4 , Dl holds position in 

LEA 

pro, AD 

; Clear prtKliict 



, bottom mimher 

MOVEQ 

ffNumSiKe/4 1, DO 


@4 MOVEA.L 

src2. A4 

: Move top number's 

ez tILR.L 

{A0) + 


aR*w 

Dl 

; address into A4 

CLR.L 

(A0i + 


m TST.L 

00(A4. D1,W*4) 

: Hnd first non /rm 

CLR.L 

(A0) + 


BNE 

0A 

; lonRW<ird tif io|> » 

CLR.L 

(AO) 1 


ABDQ.W 

#1. Dl 


DBF 

DO. m 


CMPT .M 

#Hi]inSlzc. Dl 

. 1 f top number rem. 

LEA 

pro. M 

; Get atklri'Ksof 

HBQ 

9B 

; go to end 



* pnxliict 

BRA 

99 

; Loop 

HOVEA.L 

srcl. AO 

i Move lop mmibcr's 

#A SUBQ.W 

#1. 01 


CLR.W 

Dl 

; address into AU 

BPL 

@X 


#3 TST,L 

00(AO, Di.WA) 

’ lind first non-rerm 

CLR.W 

Dl 


BNE 

e4 

; longw<wd of top» 


Muitg 
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Source Surfer. 


Introducing the incoming wave in Mac development tools: BBEdit 3.5. This radical text editor provides an 
amazing variety of ways to browse, search, and surf through your projects. 


Let's Go Surfing. 

BBHdit's Integrated disk browser provides you with 
a quick and easy means of navigatii’ig any mounted 
volume. lt"s the ideal tool for exploring developer and 
E.T.O* CDs. BBEdit also has the uirique ability to open 
multiple THINK or CodeWarrior project documents, 
either for browsing or searching. 

Can't Find It? Just Ask. 

At the heart of BBEdit's surfing ability is a powerful 
engine for searching text, cither literally or with 
UNIX ''^“Style '"grep'" patterns. This search engine Ls 
coupled to multi-file directory scanning, and the 
ability to search currently open windows, previously 
searched files, or project documents (even if your 
deveUipment environment isn't ruiuilng). The new 
"Quick Search" capability gives mteractivc searching 
as you type* So even if you don't know what you're 
looking for, BBEdit can find it. 

Project Your Feelings. 

All of this great capability would be wasted if you 
couldn't use BBEdit to write code. That's why we've 
incorporated awareness of Projector, direct support 
for ToolServer, and seamless integration as an 
external editor for use with THINK C/Symantec C++ 
(version 6.0 and later), as weO as support for control 
of Metrowerks CodeWarrior (version 1.2 and later). 

We Beg To DifL 

BBEdit's unique ability to compare folders and 
projects makes it a natural for figuring out which 
changes you made at 3 AM the night before. 


For more information: 


We caught the wave. 

In addition to its renowned surfing abilities, 

BBEdit supports the latest system software 
technologies: Apple Guide, AppleScript, Macintosh 
Drag and Drop, PowerTalk, PowerPC acceleration, 
and Quickdraw GX printing. There are gtK>dies to 
make your life easier: "soft" text wrapping, 
automatic linefeed translation, parenthesis 
balancing, auto-indent, and more. You can also 
extend BBEdit with plug-in code modules. 

(We provide information and examples to help.) 

We are the wave. 

Since its first commercial release in 1993, BBEdit 
has set the pace for capability, user interface, 
functionality, and customer support that others 
are still trying to emulate. BBEdit was the first 
cxlitor to support TwIServer, TT ONK Reference, 
Toolbox Assistant, THINK C/Symantec C++, and 
the leading-edge technologies mentioned above. 
We're still setting the pace for others to follow, as 
the first Mac text-edidng solution to deliver on 
CD-ROM with on-board documentation, the first 
text editor to support the Internet Config system, 
and the first development t(K)l with Apple Guide. 

"T Tried it Once^ But Didn’t Inhale/' 

WeVe painted a great picture, but don't take our 
word for it. 1 ake a deep breath, hit our FTP site 
(see below) and see for yourself. You'll find lots 
of things to like. 

BBEdit. It doesn't suck. 


B 


Bare Bones 

Set* tvfl! I#, Irtt- 


Accefecaiedfor 

PowerMacintosh 


lir 

MacOS 


InlcrneL bbsw@nctcom.com 
CompuServe: 73t]51,3255 
Applelink: BARE.BONliS 
eWorld: BareBones 

ftp:/ /ftp.netcom.com / pub/bb/bbsw/ 


We Also liflve "II doesn't suck" t-shirts that don't eithcTH Gill us to order. ©1995 Sore Bones Software. Int. P.O. Box lOB Bedford. MA 01730 voice: 508.651.3561 fax; 508.65L75B4 
Out (nstst wc say: BBEdit, PopupFuncs and our spiJfy logo are fcrademarka of Bflre Bones Software, Inc. Mac and the Mac OS logo are trademarks df Apple Ccatipu ter, Inc, 

used under license. Powerl^ is a trademark of IntemAtionAl Business Maclilnefi Corpuratiuu. All other trademarks and registered trademarks are properties of their respective holders. 
BBEdit was produced without hair spray, aspartame, or artlflcal cobra, and only a few gertils were inconvenienced during testing and production. 


















Power Mac and 
Macintosh 
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FIND OUT FAST 
WHAT'S GOING ON 
IN MEMORY 


THE UEHORY MINE 


Dividt: 

r Divide Old (divkioid) by sor (dMsur) aJid pm quotient in dsi. Remainder will cihI 
up in end V 

void Dlvfde{BigFix^d aigFixud *sor« BigFixed *dst) 

I 

lone pq- 

EigFixed quo« line: 

asm 


See memory allocation in any open heap at a glance, 

Easily spot memory leaks. 

^ Flags heap corruption when it happens. 

Works with source level debugger to let you find memory probtems fast. 

* Stress applications on the % with Purge, Compact, and Zap. 

Allocate memory at will for precise stress testing. 

Log heap data * easily document heap status over time. 

No need for source code: nothing inserted in (xxJe; no patches 
to the system. 

« Works with 24'bit. 32-bit, and modem memory managers. 

For Macinlosho$ willh 6BO20 or beUm. Requires Syslem 7.0 or later. 

only $99 US 

Order now from Adlanta, Inc. 

Phone: (415)781-8052 • FAX; (415)781-8053 

AppleLink: ADIAnTA • AOUAdianla • lnternet:adianta#ao!.com 

F<x VISA, MC, or American Express orders by mail, tax, or Apptelmk, please indudo 
name, address, ca rd number, expirahon date, and j^one number' or email address 

Also available through the MacToch Mail Ordor Storo and APDA 


for more infomiation contact 

$^Adia»ta, irtc. • SS2 Market St f/y 11 • San I 'nindscu, L A ^41114 


It 

movt:m,l 

IM 

MOVKQ 

CLR.L 

CLR.L 

CLR.L 

CLR.L 

DRF 

HOVEAa 
CLR.W 
MOVEA.L 
%2 TST*L 
BNK 

ADOq.W 

BRA 

TSTJ. 

ftNE 

A13DQ.W 
CMFl.W 
BFQ 
BRA 
@1 LEA 


DO D7/A0 A4, 
quo. AO 

VNinnSlze/A-1. DO 
(A0) + 

(A0) + 

(AOM 

CAO)'^ 

DO, m 
end. AO 

DO 

5Dr, Al 
Dt 

00(A1* Dl.W-4) 

©G 

#1, D1 
§2 

DO(AO. Dn.W*45 

m 

^1, DO 

i^NumSize. DO 

m 

@G 

quo, A2 


(A/) 





__ MOVEQ 

/iNuaiSize. D2 



Dl 

jlfNuinSize, U1 


SUB.W 

Dl, D2 


ADDQ.W 

CMPT.W 

; [f top 00011 x 1 -leero. 

StiBQ.W 

CMP.W 

#1. DO 

DO, Dl 


mu 

tb 

, go to end 



BRA 


, Dtop 

BLE 

m 


§4 SUBQ,W 

ll* D1 


ADD.tf 

DO, m 


arL 



@C CLR.L 

pq: 


CLR.W 

D1 




§X MOVEQ 

jfNiunSizo 1, DO 

no holds pf jsiiimi 
ill top numlxr 

m MOVE.L 

00(AO. DO.W'A), 

D] ■ 

MOVKJ, 

r;rc2, U/ 

fkutom nimiber 

MOVEa 

04(AO. DO^WA) , 

04 : 

CLR.L 


is uix king word 

MOVE.L 

00{AU 0J.W*4), 

04 : 

D2 

D2 b carry regislcr 




m HOVE.L 

00(AO, DO.W'A). 04 

(iet kmgword of 
tup number 

AODO.L 

RNE 

#1, Dl 
§E 


miLU.L 

D7, DS:D4 

Do 644vit multiply 
by brjttom tiumlxr 


MOVE.L 

D3. D4 

ADD.L 

D2, 04 

Add cany 


CT.R,L 

02 

Use D2 as dumiuy to 
extend cany 

BRA 

@F 


Atmx.L 

02. 05 

Add zero widi carry' 

@E nivii.L 

E-J, Dl:n4 


ffOVE.L 

05. 02 

High Iongw<ird 

BRQ 

m 




Ix-comes eairj^ 

40I5.L 

04, pq 


HOVE.L 

D4. OOCAJ. D0.W4J 

Put prtiaJ pnxliiet 




#1, no 

into fu'sulr 

PEA 

line 


SDBQ.W 

txMip ihnjugh all 




CHP.H 

01, 00 

loiigwords ill lop * 

MOVE.L 

04. (A7) 


HGE 

«»1 


MOVE.L 

sot, -CA7) 


LEA 

pro, AO ; 

Copy pnxluet to *'dsl” 


HulrQ 


HOVEA.L 

MOVEQ 

dst. Al 

ilfHunSize/O-l. DO 


ADDA.W 

LEA 

#12, A/ 
line. A3 


@2 MOVE.L 

(Aoy+. (Al)+ 



MOVE.L 

(A0)+. (Al)+ 


ADDA.W 

#NuiQSize * 4. A3 : 

MOVR.L 

(A0)+. (Al)+ 





MOVK.L 

(A0)+. (Al)+ 


MOVEA^L 

AO, A4 


DBF 

DO. 


MOVE.L 

D2. D5 


HOVBH.L 

(A7)1-. D0-D7/A0/A1 


LSL.W 

#7. n5 


1 



ADDA.W 

D5. A4 


1 



MOVEQ 

iNumSize. 07 



(ICJr quiilictu 


Movi; dividend'x 
adifre^ iniu AtJ 
DO cuntaiiLs current 
pfisitiim in dividend 
Move divisor's ^tklf 
into At 

This loop funis ilic 
first iiurviscru 
kmgword of the divLst>r 
& store's the p(»s in Dt 
Um>p until somr'thinR 
is found 

Fiml first lougword 
of dividend 

If wJiolc dividi-rid zero, 

go to end 

IXKJp 

Atldn-ss of quotirnt 
b stored in A2 
D2 coiiinins curn.‘in 
position iu quolieiU 
i'irst pusitiun will 
be NumJibx; - D1 
tr divideruJ smalkr 
thin dtvistw, 
then gi> to end 
Add 10 quf Hiciil 
"pq' holds part id 
quotients 

Take A (|u;idword fnmi 
dividend to use 
3S partid tlivkiend 
■fake a iongwoid from 
divisor ami 
Juki one 

tfilivbiunoi ^ero. 
go do division 
ilse, we art dividing 
hySHKKKJ.somove 
high longwdftl of 
di videmi iolo r| not tent 
Do f^^’bii division 
lioneh if qiuiljeni ^eto 
Add quotieiu to 
p^urtLd quotient 
Multiply qmuieni 
by dKisor 
and stcire in iine' 


Ckt quotientdivbor 
pnMltia 
Now suhiraci 
frimi dividend 
€py divkieml addr to A4 
t)2 ludds Ifywr^l [los 
of dividend to sub fri)m 
Add it to t>ankJ 
dividend aiklress 
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Gives you the Information to Program your Best ! 



Information 


The Debugger V2 
& MacNosy 

By Steve Jasilii 



Control 


T he Debugger is a low and highdcvcl symbolic 
Debugger that runs in a full multi-window 
Macintosh cnviroiuncut. You can trace program e?fe- 
cution, view the values of variables, etc. qf both 66K and 
PowerPC programs. 

HacNosy is a global interactive disassembler that 
enables one to recover the source code ol' any Mac applica- 
tlon, resource file or the ROM. 

Wlicn you compare features of the different debuggers, 
note that, onh/ one has aD the below fealures to help you get 
your job done, and on/y has Mar Nosy to help you debug 

tiny program in a lull system (6.Ox or System 7.x) environ 
ment symbolically I 

It is the ortfy debugger to use the MMU to protect your 
CODE resources and the rest of the ^stem from the pro¬ 
gram you are debugging. Wilh MMU Protection you can find 
errors when they happen, not millions of instructions lalcrl 
(Macintoshs with 68030 CPUs only). 

The Debugger is the debugger of choice at; Adobe, 
Aldus* Claris. Electronic Arts. Kodak, Metrowerks, cLc. 


lUincltiiuRecorcL046532O 


UindowRecord 


o 


0 port 

CGrafPortJe466320 


t08 iM i ndouiK i nd 

3 


t10 visible 

TRUE 


til nil tied 

TRUE 


!12 gofluiayF 1 ag 

TRUE 


113 spureFlog 

TRUE 


114 strucRgn 

^"" Reg i on J&483974 


118 contRgn 

**Region_@485534 


122 updateRgn 

*"R©gion_e4859BD 


126 w i ndOuiDe fProc 

*-DEF funRsrc_^8768F0 


130 dataHandle 

@485970 


134 titleHondle 

@485918 = "Unti tled-f 


133 iiileyidlh 

67 


140 ControlList 

MIL 


144 nextUiodoiM 

^ 14 i ndowRecord J@465273 

o 

148 lUindowPic 

MIL 

152 refCon 

$00464F23 



An excanpie of a sfnjc(un?d data display u;indou) 


Its Features Include: 

• Symbolic Debugging of any Macintosh pro^mn, ROM. or 
wde resource (DRVRs, XCMDs. INFfs, PDEEs, 4DEXs ,.) 

• Source level debugging for Metrowerks & MFV compiled 
programs (C++. C. Pascal. Fortran, and an Incremental 
Build System with instant link for super fast development. 

• Object Inspeetor for MacApp 3 programs 

• Source level debugging of Think C™ projects 

^ Includes a program (CoverTest) to interactively do Code 
Coverage analysis for SgA testing, etc, 

• Simultaneous Symbolic debugging of multiple "tasks” 

• Fast Software Watchpoint command to find clobbered 
variables 

• Sophisticated error cheek algorithms such as Trap 
Discipline (Argument CbeekingJ, Handle Zapping. Heap 
Scramble and Heap Check to detect program errors before 
they become disasters 

• Structured display of data (hypertext) with user definable 
stnictures while debugging 

• Conditional breakpoints to help filler out redundant 
Information 

• Continuous Animated Step Mode to walch your program 
execute iiislruction by instruction 

• Detailed symbolic disassembly for both 680x0 and 
PowerPC with symbol names, labels, cross ref maps. “ 
make it possible to ferret out the secrets of the ROM, etc, 

• ‘Training Wheels" for the PowerPC disassembler to help 
you learn the opcodes 

The Debugger V2 ft MmcNosj: $350 

Runs on all Macs. Call For Group prices or Updates. 
Visa/MC Accepted. 

Available firom; Jasik, APDA Frameworks or 
ComputerWare (800-326-0092). 


Jasik Designs • 343 Trenton Way. Menlo Park, California 94025 • (415) 322-1386 

Internet: macnosy@ja8lk.com • Applelink: D1037 



















Superior 
Copy Protection 

t MAC/tock makes you money 
* MAC/toek IS SAFE, TRANSPARENT & EASY 
^ MAC/tock IS aggressivety priced 
^ If AC/iock works pn Macs & Power PC^a 
^ NETt/pek provides LAN license control 
^ Broad Prodoet Range iiclodes PARAftoek (PC) 

Spending (25+ for copy protection should get you more than a pretty dongle. 
Please let us explain why M AC//oek's micro processor is superior to old 
fashioned ASIC Icchnology* Call us TODAY and order your Developer API 
We will also send a kit to get you started on filing your copyright application. 

800-909-3141 


EAGLE DATA 
PROTECTION 


On CompuServe GO PIRACY 

# SilLikeCly.ytih «4111 • FR^BPI-SM-aZDP 




SUB.W 

Dl. D7 

; D7 holds nunilx'T of 


SUBQ.W 

SHI 

#1. D7 

DS 

; hingwords to snhtr^ci 


MOVE.l 

(Afi), D6 

; Subtract least 


SIJB.h 

HOVE.L 

m}, nfe 

D6. tA4) 

; significant longwortls 


tST.B 

Di 

: if durre are not siny 
; more longwords 


BNE 


; to subtract, bnimrh 


SUBX.L 

-(A3), -(AA) 

; Subtract rest of 


DBF 

D7. m 

; !ongwofitl.s with btimm 

m 

BRA 

m 

; liiop and divkir again 

#D 

MOVE.h 

pq, DA 

; (k-t acenmiilated 
; partial quoLient 

§8 

MOVE.L 

DO. D5 

; Now check to sec 


ADDQ.L 

#1. D5 

; If partial dividend is 


HOVE.L 

Dl. 06 

; less than divisor 

m 

MOVE.L 

D0(A1, Dfj.WA), D7 

: Get longword of di visor 


CPIP.L 

no (AO, ni.wA), r>7 

; Oimparc with long word 
; of dmdetid, branch 


BCS 

m 

; if dividend bigger 


BNE 


; If divisor bigger. 

; then branch 


ADDQ.L 

DS 

; If these two longwords 


ADDQ.L 

#i, D6 

; were =, then eompre 


CMP.W 

D?., DS 

; m‘xt two longwot^tls anti 


BLE 

#5 

; continue 


HOVEA.L 

Al. A3 

i Subtract divisor fftmi 


ADDA.W 

HOVEA.L 

MOVE.L 

LSL.W 

HOVEO 

ADDA.W 

SUB.W 

SUBQ.W 

sm 

#NutiiSize ’ 4, A3 

AO. A4 

DZ, DS 
h. D3 

D7 

D5, A4 

Dl, D7 

D7 

D5 

; partial dividend 


MOVE.L 

(A4). De 


SUB.L 

-{A3), D6 


MOVE.L 

S6. (AA) 


TST.B 

D5 


BME 



§7 SUBX.L 

(A3). (A4) 


DBF 

D?. dl 


S6 ADDQ.L 

il. D4 ; 

, Add one to quotient 

BRA 

08 ; 

; Lch>p and compare again 

§4 HOVE.L 

DA. 00(A2. D2.r4) ; 

ri, 02 ; 

#1. DO ; 

; Store partial quotient 
, in whole quotient 

ADDQ.W 

, Increase quotient pos 

ADDQ.W 

p Increase dividend pos 

CMPl.W 

#NunSize, D2 


ALT 

ec i 

, Ujop until done 

m LEA 

quo, AO : 

p Otpy quotient to ’‘dst” 

MOVEA.L 

dst. Al : 

; Remainder will automat- 

MOVEQ 

jlKuii>8l7.e/A-1, DO ; 

; icaJlyendiip 

ftO MOVR.l. 

{A0)+. (Al)+ ; 

, in dividend 

MOVE.L 

(A0)+. {Al)+ 


MOVE.L 

(A0)+. (Al)+ 


MOVE.L 

tA0)+. (Al)+ 


DBF 

DO. eo 


MOVEH.L 

(A7)+. D0-D7/A0-AA 



I 


(jimparc 

/* Cuniparc mvI and m'2. Kcmm;> 1 if sTt l > breZ. 0 if they’re txfual, and - I if frcl < 
rcZ. V 


chort Compare(BlgFUed *srcli UigPiJted *src2) 


( 

HOVEH.L D1/D2/AO/A1, '(A7) 


MOVEA.L 

srcl. AO 

: Get pStcl's address 

MOVEA.L 

src2, Al 

; Gel srtrZ's atklress 

MOVEQ 

l\ . DO 

D2 

; Start with-»-! 

MOVE.L 


OKF.L 

{Al)+. DZ 

; Gumpm-1 St longwords 

BLT 

@1 

; If sfcl less, branch 

BNE 

@2 

; If !=, sre 1 must 

HOVE.L 

(A0)f. D2 

; be greater 

CKP.L 

£Al)-f* D2 

; (’m p 5 iTiiJit' longw ortls 

BCS 

@1 

; (Ciisigned) 

BNE 

92 


MOVE.L 

(A01+. D2 


CMP.L 

Ul)+. D2 


BCS 

91 


BNE 

92 


MOVE.L 

(A0J+, D2 


CMP.L 

(An + . D2 


BCS 

@I 


BNK 

92 


MOVEQ 

fNuiiiSize/4-2, Dl 

; Numl>er of lungwordii 
: remaining / 4 

MOVE.L 

(A0)+. D2 

; Compare 4 longwords 

CMP.L 

{Ai)i. DZ 


BCS 

9i 


BNK 

m 


MOVE.L 

(A0)+. DZ 


L'MP. L 

(Al)-i-, D2 


BCS 

91 


BNE 

§2 


MOVE.L 

CA0)+, DZ 


CMP.L 

fAiH, nz 


BCS 

@1 


BNK 

92 


MOVE.L 

fAO)-^. DZ 


CMP.L 

(Al)+. DZ 


BCS 



BNE 

92 


DBF 

Dt. #3 ; 

^ ijoop 

CLR.L 

DO 

, If wc giti here. 

BKA 

92 

p then SIC I - sicZ 

MOVEQ 

^1. DO i 

i sn. l is Jess 

MOVEH.L 

^A7)^’, 01/D2/A0/A1 



) 
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World’s Leading FORTRAN 77 for Macintosh 

68K and Power Macintosh versions 

•full ANSI 77 native compiler 
•faster execution speed 

• graphical source-level debugging 

• two complete graphics packages 

• make utility, MRWE application framework 

• System 7.5 compatible, MPW included 

• Windows 95/NT version also available 

absBft 



Visit us now at http://www.absoft.com 

2781 Bond Street Rochester Hills MI 48309 • (810) 853-005( 

) • Fax (810) 853-0108 ♦ sales@absoft.com 


Get Your Name “In Lights” 


n iivc you over thcjuglu hIxjuI writing an anitle? Tlie uditoriul 
sialT at MacTet'li Magji^i^inu would like to personally invite yt>u to 
write for the piil>lkarii>n. While writing an artide Is not diflleull, U 
take a liit of time. But, you gel to share yntir kntiwiedge 
with die rfMTimiiniiy, see your names ‘'m lights’*, and ... you gel 
paicl for yonr efft^ris! 

1b get started, y-ou am download the Mae fed i Wnier's KJt rn:im 
one of our rmline support areas. Here you will liml inftHiKition on 
ht)w t<^ submit an article - and it comes with ejuiinples, templates and 
style sheets. Keel fav to e-mail us with t|uesiioris. 

Call FOR Articles 

Many of you liave Risked “whar topics w(mld we like to seer Our 
lulitcM^ Boiird and Stall has piovkJtxi insight as to wiiai the magazine 
will tover in J99b Our gfxil at Thtt magazine b> to pulilish articles on 
diveise !o^>ks tliai am sum to kemp ixir madeis lx>th inierestcxl and 
w'dl-infonned throughout dm year. If you'd like to lx* part of this 
git Hip, diink alx>ui what you know aix>ut - dial's wliat well lx* mosr 
intemsied tn — and what you 11 be the Ixsl at writing, As a guideline, 
you cm diink alxjut one of die following issues. 

For example, topics that include articles that teitcli debugging 
techniques and advix'aie g<K>d debugging uiols. This conrmue,s 
our diemc about making soliw'are more reUahie, We will continue 


to talk about “cool" Ajiple ieclinok>gy such as QuickTime VR, 
QuickDraw GX, Dynamic languages; or as our Editor at-Laige Scon 
1' Boyd siiid, “software that takes us oul of the Stone Age."* 

Iliere will lx* tijxs on how to get your business on the Intemel 
and how bn.sine.ss models are shaping up. More heavy-hitting 
deep technology artieles will be included, such as the recerU 
articles on CGI development, CF+ Exception Handling, etc. We II 
see ctinrinued coverage on the developiimnis in OjmnDtm, as 
those in tJie industry decide what to make of this new software 
mcxlel. 

MacTCP is another aan tif imptniance, as more petjple get 
excited about providing Maciniosli-qualiiy software for Internet 
users. You will see additional coverage on Visual Programming. 
You should also ex peel to see more on cross platform 
tievelopmenl. And. even though if.s a moving tiUget, wc will Im 
covering Apple’s next System Software release - Copland. 

for Maciitioth 

frosiFitMmgtt f tifff{often 

fMTMr 

MAGAZINE 


E'lnail us with your idea and let’s talk. You aever know, you might get your name '‘in lights”! 


Novi-:miikh 199 ^ • MAcTEciiMAt;A/iNE 
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neoShare 


Client/server 
Object Database Engine 


Collaborative Computing 

NcaSharc™ is a collaborative computing engine ihai objcci-orjcnieti developers use to create data intensive 
distributed applicaiions. Its clientyserver architecture provkles shared access to objects by multiple clients. Ihe 
server can co-exisi within a client application t>r ojKTaic in the coniext of a dedicated process. Clients can reside 
5 on the same machine as the server or on other machines across the nerwork. No other multi-user object database 

^ engine can match NeoShare^s feature set, impressive fXTformance^ mcredibly small resource lootprini, easy to use 

ycl extensible programming interface and generous pricing structure. 

Full Featured 

NeoShare consists of a set of C++ classes that furificr extends the features of NeoAccess**^, our cross-platform 
object database engine. Taken together, NeoAccess and NeoShare form a feature-rich groupware toolkit that 
addresses a complete set of collaborative development ret(uiremcnis, including; object persistence, organizing, 
searching, transponing, sharing, locking, updaiingand concurrency control. 

fhe collabomtive capabilities of NeoShare include; clieni/server connectivity, concurrency control, objeci locking, 
transactions, a hotTink facilily, t lieni-skle caching to reduce network irafltc and object overwrite deteciitm. Tficse 
two professional quality developmeni tools form the loiindation upon which data intensive distributed 
applications arc built. 

Full Source Code 

NeoLogic has taken a frameworks approach with our object-oriented development tools. In much the same way that 
applkaiton Framevvorks arc used iti construct the front-end of an application, NeoAcces.s and NeoSliare are the 
frameworks you use to build your application’s coflaboralive back-end capabilities. This allows you to fttcus on the 
value-added portion of ihe apfilication - the pan that you know best. 

As is the case wiih vinualty all object frameworks, the NeoShare Developer's Bundle come.s complete with full 
source code Sti yem have the sccunty of knowing that NeoShare technology is always at yciur fingertips And our 
extensible architecture allows you to evolve your toolkit into domain-specific arca.s. 


Easy to Uso 

Migrating your appliailion source code from NeoAcccss to NeoShare is easy heiTause ihe programming interface of 
boih products is virtually idenucal. This interlace is designed around the conccftt of minuTitim visible complexity. 
NeoShare ttaturally extends NcoAccess to add object sharing between clicnis and st^rver. Objects ttbtainetl from a 
server across ihe neiw<irk by a diem are real C-i -r objects. You treat these olqccts as you would any oiIkt object. 

NeoShare iru:lude.s two concrete subclasses of the NcoAccess database class; a client and a server. Virtually all the 
complexities associated with shanng objects across a network have been hidden Ix-hind the interface to these 
database subclasses In application code, a server database objeci appears very much like a local database, except a 
seiver daialxist^ alst3 handles mcptesis received from client applications. As clients retpiesi objects from a server, the 
server mainiains a set of locks associated with those olDjects. When the .state of an olijeci in a server datalxis^' 
changes, all clients holding locks on the object are automatically seiU die object's new slate. 

A client oljjecL also supports the same application programming interface as a local daUthase. Yet the implementation 
of this interface may involve sending a request to the mmole server The server j.uTforms the requested opemtion 
anil stmds the residts ol this operation back to the clierii. The caller of ihe clietji dataljasc needn't be aware of the 
fail lhai die database objeci on which it relies is in fact delegating ofK-rations to a server database across a network 
mlerface. The network is transparent to the application develofx^r 

Affordable 


Tile NeoShare Developer's Bundle, which includes NcoAccess, sells for just $12!>d pt^r developer with no rimiimc 
litamsing fees, li includes full source code, sample ap]ilicattoiis, online doemmentaiion, and 30 days of online 
technical support. Site licensing, as well as cducaiioiia! and volume discoums are also available 

NO 

neo®logic 

Professional quality object-oriented development tools 



1450 Fourth St.oSuite 12®Berke!ey OCA994710®(510) 524-5897® rieo!ogic@rreologic.com 









SYMANTEC 
TOP 10 


By Levi Brown, Symantec Carp. 


SYMANTEC J 


This monthly column, 
written by Symanteds 
Technical Supp€trl 
Engineers, aims 
to provide you with 
technical information 
based on the use of 
Symantec products. 


Q: 1 scL my project's preferred and 
minimum memory partition sizes in 
the “Project Type’’ window, hut 
when I build my application, the 
preferred and minitiuim memory 
partition sizes are always set ro a 
different value. What Ls wrong? 

A: The prt)|eti’s resource file contains a 
STZK rcMJurce that always overrides 
the value set under the Project, 
Options..., Project Type’' window. 
Id solve this problem, open tfie 
Pro j cctName . rs rc resource 
file with ResKdii and delete the 
SIZE resource. 

Q: I have heard of this program called 
Discipline that works with Maesliug 
to provide a higher level of error 
checking. What does it do, and does 
it work with the Symantec Debugger? 

A: Discipline is a system extension that 
works with MaesHtig check the 
arguments passed to Toolbox 
routines. Discipline is built into 
MacsBug 6.5dl2. In access it, you 
use the demd dizy. 


Our debugger has not been tested thoroughly with 
Discipline. Therefore, it is p<sssible that you may run into 
some incoitipatibiliries. Discipline has a habit of revealing 
problems with many different programs including the 
Finder, which makes it difficult to use as a debugging tcK>l. 

Q: In UNIX there is a col lection of routines, declared in 
curses .h that can l>e used to manipulate liie curscjr in a 
console-like display. In my Symanlec C++ 8.0 project using 
the console window how c'an I aclijeve stmiiar results? 


A: Most of the functionality of the console window is declared 
in console.h. I lere is an example of how to move the 
cursor to a specific point, and clear every riling in the 
window from that point down. 

linciude <stdioTi> 

Iflrtfilude <coasoieJi> 

malnO 

i 

int i, cb, rows = 12, cols " ^0: 

con&ole_Qptionafnrovs = rows: 
r.onsole_optioTjs.iicolB = cols: 
rnhowt stdout )^ 
cecLffliodet C HOECHO. stdoui )i 

//Scl Diode 10 C^NOFCHO, so 
// RCtdur doi^sn’l Diovt: Ihc 
// L-ufS(jr. 

fort i=0i i<r«w«*('ols: i-H- ) 
putcharC 

egotoxyt 5. 3, sidoul ): 
cti ^otchart): 
cclcoJit fitdoDl ): 




XXKXXXKKXXXXXXXXXXXXXXKXXXXXSOCXXXXXXXXXX 

XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX 

XXXXXXXXXXKXXXXXXXXXXXXXXXXXXXXXXXXXXXXX 

xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx 

XXXXXXXXIXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX 

XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX 

XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX 

xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx 

XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX 

XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX 

XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX 


Befvtv the call ft) cc 1 eos () 
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You’ve spent 

enoi^ 

time in 
development. 

Don’t let your 
installer keep 
you from going 

golden. 


I @ Spetified Folder 
JQ User Spetined disk 
(Q Startup Disk 
O Desktop 

He Hue Dpple Menu Items | 
HcMue Control Panels 
Hctlue fKlensions 
DcNue rents 
Hetiue Preferences 
Detiue Slartiip Hems 
Cl} ncljue System folder 


flny DBDitO 
Any PoiuerPC 
bUODO 
6BOZO or higher DDUhO 



Just because your 
software is done doesn’t 
mean your work is. You 
still have to write an 
installer. And that can 
add precious days or 
even weeks. 

With Aladdin 
Systems’ proven 
installation standard, 
Stufflt InstallerMaker,™ 
you can have your 
PowerMac® or 680x0 
product ready to ship 
literally within minutes, 
and save money to boot. 

Stufflt InstallerMaker 
uses our advanced 
compres-sion technology 
to reduce the number 
of disks needed to ship, 
which saves you money 
on every unit. Its menu- 
driven interface is so 
easy-to-use that even 
your VP of Sales could 
prepare your installer. 

New version 2.0.2 
adds full PowerMac 
support, improved 

scriptabUity, 
and 

expanded 
localization, 
including German, 
French, and Japanese. 

Ti) receive a free, 
fully-working copy of 
Stufnt InstallerMaker, 
call our liceasing 
department today at 
(408) 761-6200. 



O lim Ahl(l(t1tl%idii4ni, litr. 166 Wi^ricl|Sf Tkiw, 
U^twilhs [^; (out) Till 

bl«tiailnsv 4 : uf 

AbiMai Ihc. All irtlwr praducU aie 

lndbnal& af iWr rivqintliHi M 



After the call /o c c l e o s () 


Q: Fni using tlic TooIBox call Get Picture () ami 1 want to 
clean up the memory after I am done with tlie pidiire. How 
tlo \ do that? 

A: Pass the handle that Get Pic ture () returns u> 
ReieaseResource (), Do nor call 
DlsposeHandle () on a fiandle to a resource or you 
may tomipl the resource map. 

Q: When I try to use the QuickDraw global variables in my 
Symantec C++ 8.0 project I get unclefined symbol errors. 
Tve used the same globals many limes iK'fore using 7.0 and 
it worked just fine. Wliai is happening here? 

A: Willi tlie intixxluction of Apple's Hniverf^l Headers, access to 
the QuickDraw glolials changed, Your 7.0 prriject was 
probably refening to die QuickDniw glohals in the “old” style 
and using tlie f>rigina! header files, n<Jt the Univers;il Headers. 
You will need to aemss the QuickDraw glolials thniiigh the 
qd struct, defined in Quickd raw, h * i.e.: 

CopyRgn (thePort - >visHgri * theFort ->ciipRgn} ; 
would lx.‘come 

CopyRgn{qd.thePorL->vlsRgn, q4,thePort >clipRgii): 

Q: 1 liave a large 8.0 project with many files and 1 frequently 
use the Find... command under the Search menu. Every 
time I u.se it 1 have to set up the find parameters each time. 
Is lliere a way to set default searcli parameters? 

A: Yes! In your Symantec' C++ folder tiiere is a folder called 
(Scripts), inside which you will find a compiled sen [it 
called Startup: 

tell application "Symantec ProjerT Manager" 

Set t/ie default search mtaic. 
set user search state to 
(wrap around:true, 
ignore rane:lrue, 
files to Sfcarcbionly sources, "• 
exclude system:true, ' 
exclude precompiled header;true! 
end tell 
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You can set the default parameters for the find in the 
indexed list shown alx>vc. 

Q: I get link errors with a class that has static data ttieiulx.'rs. 
Why is this? 

A: If you declare a class with static data memlx.T.s you need to 
initialize those data members in tfie gltjbal data space outside 
the class, so tlial memory is allocated for them. If you do not 
initialize the static variables in global data space outside the 
class then the compiler does not have a location for the static 
data memix'rs in mernoiy'* Tfius, you get a link enor when 
you aUcmpl to access that variable. Example: 

class A 
1 

public; 

static short x; 
static char y: 

char z\ 
i: 

short A;: X = 0: // Note; These vaiiabicis arc injtklt^a 

cha r A;: y " ' a ^; // outside the class tieelaratton iti 

// order to allocate meniof)’ for them. 


Q: The following code used to work (up through 8.0)^ but in 
8.0.1 it doesn’t. Why? 

class A 
[ 

friend class B: 
public; 

AO; 

-AO: 

B •GetFrieiidOnl Index): 

I ; 


class B 

I 

pjjhUr, i 

R£); 

-BO: 

int index: 

t: 

1 get an error on line 7 ^semk:<>ion expecied'’. If I put 
friend before B * GetFr iond (int index), it 
works. Is ii a compiler bug. or is ii a new' ANSI rule of 
some kind that I didn't know' almut.^* 

A: A couple things are happening here: 

First, the code above compiled in previous versions due to 
a compiler bug. 8.0.1 coirecLs this error. Basically, the 
syntax is wrong. The class A has no idea what B is yet, and 
thus the compiler complains. If you put a hsrward 
declaration, class B:, in fnmi t>f the dedanuion of A 
this will com[)ile ftne. 

Second, the statement friend B *GetFricnd (int 
index} lells the eoinpiler tliat GetFriend is a friend 
function, and therefore has access to A's protected and 



VIS UAL; T E R FAC E GEN EiRATO R 


i-800-252-6479 


1-703-689-9593 fax 
Language Systems Corp. 

100 Carpenter Dr. Sterling VA 20164 
http://wwwJangsys.com/langsys 


U N c 


LS Object Pas 


OPTIMl^rNG COMPILER FOR 68K 


AND PowerMac ; 


Complete programming 


ENVIRONMENT WITH OVER TOOMB 


OF TOOLS AND DOCUMENTAT ON 


Source code generator 


Plus 


NATIVE PORTING KIT FOR 


MACAPP 2,0 


COMING Soon! Support for 
Symantec Project 


MANAGER 8,0 


CALL OR WRITE FOR MORE INFO 
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MacForth Plus & £> 
Power MacForth ^ 


The Language of Innovation is now 
available native on the Power Macintosh. 


FEATURES 

■ Royalty Free Turnkey 
Compiler 

■ Text Editor 

■ Online Glossary Tool 

■ System 7 Compatibility 

■ 68020 Assembler 

■ 68881/2 Co-processor 

Support 


■ High Level Graphics 

■ Toolbox Support 

■ Extensive Documentation 

■ Reasonable Upgrades 

■ Optional Tools Disks 

■ MacForth Plus $199 

■ Power MacForth $199 



C/uatlve t’HC. 

4701 Randolph Road. Suite 12 
RoclwHIe, MO 20052 

3Q1-984-0262 or 1-0OO-FORTH-OK (orders) 
Fax; 301-770-1675 Applefink: CSl 


])riv;tiij nicnilK;rH. The siLitemenf B *^GetFrieiid (int 
index) tells the tompiler iliai GeiiFriend Is a meml>er 
funaion of A. in IxJih easei the friend class B dws 
noiliinj' more ifuin allow all memlx^rs of B acces^s to A*s 
private and pnHccted meml>ens. 

Q: 1 have made a lloaiing winik)w view in Visual Arehitect, but 
when I to attach it to a eonimand, it does not apjX'ar in 
the list of views to open. How do 1 opem it? 


Next, attach the command to the menu or button. If 
attaciiing to a menu: choose Menus.., from the Edit 
menu, select the menu, click on Edit Menu Items, select 
the Item and choose the command you created from tlie 
Command: popup menu. Jf attaching to a bunon: select 
the button in VA, get Pane Info from the Pane menu, 
open the CButton triangle and chcxjse the command you 
created from the Command: popup menu. 

Visual Architect will generate an empty function, 
DocmdOpenMyFWindow inside x CApp*cp. Call 
Open Wind {) from here. 

Note: Calling from outside the CMyFloatingWindow 
rec[Liires that you have a pointer to the 
CMyFloatingWindow object. You can find this 
declared as a global in x_CApp. cp in the fonn: 

extern CAFloatingWindow ^gCAPlaallngMinfjuw: 

If you wish to make the call to QpenWind{} from 
someplace other than x CApp . cp, you iiiu.st rcdcclare it 
(as above) and //include CMyFloatingWindow,h 
in die file where you want to use it. 

Q: When I try to nin the Symantec Debugger it quiLs with an 
error that says, ^DelxigServices cannot scl trace bit." How 
do I .set the trace bit? I can't find any options to set a trace 
bit in any of the project option debugging .screens. 

A: Most likely, yoti are running a Pre-System 7.5 operating 
.system. You will need to pul the items I fiat are in the Pre- 
System 7.5 Additions folder into your system folden Tlie 
Pre-System 7.5 Additions folder is found in the Apple 
Software folder on your Syrtianiec' C++ 8.0 CD-ROM, 

Bonus: 

Q: I'm porting my code from 7.0.x to 8.0 and I get an 
"undefined symlx>l HBarHeight" wlien I try to cxHiipile. 
Why do 1 get a linker error? 


A: When you make a dialing window view, VA derives a class 
from CFloa t Di r Gc t o r; we will call ii 
CHyFloa LlngWindow. You need to call OpenWind ( ) 
to make ihc window appear (ShowWlndO only undtx^s a 
HideWindO). Tlie easiest way is to atll it from within 
CMyFloatingWindow: :MakeNewWindow (), righ! 
after the obfect is created; the window will appear 
immediately ufxm laurkli, 'fo have it open from a eommand 
(i,e. menu or button), create ihe command by ch(K>sing 
Commands... from the Edit menu in VA. Enter Lite name 
for your command (e.g, cmdOpGiiMyFWindow), chtwse 
CRpp from llte In Class: popup menu and chcxxje Call 
frt)m the Do: popup menu. 


A: With the intiXKliiclion of Af)[3le's Universal Headers you ran no 
longer access the variable HBarHeight directly. You will 
netxl to include T.owMem. h aixJ ase LMGotHBarHeight (), 
and LMSGtMBarHGight () f to access menu bar height. 
Access to other low memory variables lias l>ecn changed in 
similar ways, so ifs a gcxxl idea !o Ux>k in LowMem.h if 
you plan on using low memory variables. 

Spfciai. Thanks To: 

Cflenn Au.stin, Mark Baldwin, Craig Conner, liick nartmann, 
Michael Hopkins, Steve Howard^ Noah Lieherm:m, Andy 
McFarland, Chris Prinos, and Kevin Quah. 

M 
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neoAccess 


Cross-Platform Object 
Database Engine 


S 

I- 


Full Featured 

Now you can emlied ilie jMJwer of a fitll-fcaturccl objccl-oricnlcd database engine into your Macintosh. Windows, 

Unix ami DOS leased appluaiions. No oihor object database engine can maich NeoAccess's impressive feature set, 
including: Blnlis, pan lists, itcraiors, swiz 2 :lcrs, temporary objects, multiple indices on a class, Inveried indices, 
siored queries, schema evolution, a powerful relational query mechanism, a streams-based i/o model and incredible 
per fort nance. 

High Performance 

Ultenially, NeoAccess u.se,s extentied binary tmes and binary search 
algoriilims to achieve optimally short access limes. Us automaUc 
query optimizer ensuTcs that quencs always use the fastest access 
path to objects. And indices are dynamically combined, collapsed 
anti com premised to keep access times to an absolute minimum as 
the contents of a database changes. NcoAccess's object caching 
botisis performance by keeping objects m memory even after being 
disp<.>sed of by the application. Your application's memory size is 
reduced because only those objects of immediate interest need to be 
in memory at any one time, not the entire file. 

Full Source Code 

We've taken a fmrnewtjrks approach toward object persistence and database technology. In much the same way that 
afifjlicatiori frameworks arc used to construct the front-end of an application, NeoAccess is the framework you use 
to build your application's back-end. As is the case with virtually all object frameworks, the NeoAccess Deveioper's 
Toolkit comes cornpleie wiih/u/f source code, for all major application Immeworks including Meirowerks* 
PowerPlant, Symantec's THINK Class Library and Apple's MacApp on the Macintosh and MicrosofLs 
rmmdation Classes. Inmark's zApp and Borland's ObjectWindows in Intel-based environmems- It can even be 
used with out a framework or in one that youVe designed. 

Easy to Use 

The programming interface is designed around the concept of minimum visible complexity. Applicalioii-specific 
objtxis inlicni persistence propcTtics from a NeoAccess base class. 1 hese objects are organized In the database 
primarily by class. But NeoAccess also knows how classes are related. So multiple classes can be searched in a single 
ofxration. And of course objects of any particular class can be organized using multiple indices. NeoAccess is 
unique ui that it allows objects to be located based on abstract selection criteria or based on their rebiionship to 
other objects. There's literally no database admimsuition to deal with - NeoAccess lakes care of all the details. 
NeoAccess also includes a Blob mechanism which allows freedorm variable-length data to be stored in databases 
with the same ease as fixed-length objects NeoAccess even includes a powerful set of keyed iterators for traveling 
indices and part lists. Keyed iterators have the unique ability to iterate over only those objects in a set that match a 
given selection criteria. Your users will appreciate NeoAccess because databases are completely self-contained in a 
single document file. So users can treat a database file as they would any other document. 

Proven 



NeoAcceiCs has 1>een commercially available since 1Q92 Thousands of commercial and in-house applications based 
on NeoAccess technology have already been deployed. NeoAccess can help your organization deliver powerful 
products in a more timely fashion than you ever imagined possible. 

Affordable 


NeoAccess^s best feature is its j>rice. Tlu* NeoAccess Developer^s Toolkit seifs for just $74^ per developer with 
absolutely no riinitme liceri.sfng/cfrs, It includes full source ctwfe, numerous sample applications, 500 pages of 
documentaiioii, and TO days of technical support. So whal are you waiting for? __ 

Ose NeoAccess ^ 

, voUT developmenOorotK^-, 

neo°logic u— 

Professional quality object-oriented development tools 



1450 Fourth St.oSuite 12 o Berkeley oCAo94710*(510) 524-5897oneologic@neologic.com 














PASCAL 

ACTIVISTS 


By Brian Arnold and Guy McCarthy 



MacApp Pascal Rides Again 


Volunteers convert 
MacApp Pascal to generate 
native PowerPC code 


In 199^, Apple stunned Macintosh 

developers hy Jinnoimeing tliat it whs 
dropping MPW Pascal support from its 
compiler suite and from MacApp, their 
premier application fnitncwork. This 
was a shock, given that Apple had been 
advising developers for years to 
program in Object Pascal with MacAp]^ 
for maximum compatibility with future 
redint)logy. 

MacApp developers split into twi) 
camps: those able to make the arduous 
transition to C++, and those wlio could 
not justify the expense or were 
unwilling tc> abandon Object Pascal. 
*rhe latter group faced an uncertain 
future, and liopes of porting exisling 
MacApp applications to nin native on 
the new platform were slim. 

Before the fateful announeenienl, 
Apple and Ltnguage Mysiems had lieen 
collahorating c:>n the next generation of 
Pascal compilers fcir ihe RiSC-based 
Macintosh. That project^ however, was 
ultimately scrapped w'hen Apple 
decided to drop multi-language support 
from iLs RISC compiler architecture. In 


December of 1993, development of LS Object Pascal began 
again, this time using soLirce code from Apple’s MPW Pascal 
compiler as the base. It was a long and dilBcult task to merge 
the aging MPW Pascal source code with Language Systenfs 
FORTRAN technokjgy and update it for the PowerMacintosh. 

In May of 1994, the first native Pascal sample program was 
shown to an enthusiastic crowd of Pascal supporters at lire 
World Wide Developers' Conference. Shortly after, a grass-roots 
cooperative of Pascal MacApp developers was formed to 
investigate the possibility of porting MacApp native with the 
Language Systems compiler The Ma<’App2i^PC co-op (as it lias 
come 10 Ix! known) was organized by Brian Arnold of Lumina 
l>ecision Systems. This group of volunteers proceeded to 
accomplish what the corporations could not. 

Over the next several months, contributors on three 
continenLs began tlie lengiliy process of converting the entire 
Ixidy of MacApp 2.0,1 source code. In Octol>er, an FIP site and 
Web page were operational with a preliininary version of the 
scripts and documentation (see iielow). In November, key 
changes to the compiler's runtime architecture were 
implemented to .satisfy requirements of the group. By 
December 1994, all of the c:onverted source code was ctjmpiling 
sucL'essfuily with Language Systems' beta Object Pascal 
compiler. Only runtime is^sues remained. 

in February, the target relea.se date of May 1995 was set to 
coincide with the Worldwide Developer Conference in San Jose, 
California. Pinal technical issues were addressed during a 48 
hour **Hack Session” on March 17-19 in nearby Menlo Park, 
l.anguage Systems sent two compiler engineers with Power 
MacinU>sh CPUs to aid the effoit. 

The Hack Ses,sion was a success. Farrkipanrs (some of 
them opr^raiing rtfinotely) included: Masailiro Alx.\ Brian Arnold, 
Colleen Barton, Per Bergland, Greg Branche, Larry llainel, 
Steven Uopkins, Eric Jackson, David Johnston, Steve Uivagnino, 


Btian Arnold and Gfty McCarthy - Brian Arnold, Director of S<jltware Development at Luinina Decision Systenis, Is an 
ardent supporter of OpenDfx: and MacApp 3..5* but his company badly needed PowerJ*C native versions of legacy OhjetH 
Pascal MacApp2 code. Guy McCarthy is President anci CPO of language System.s Corp. 
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Simply the best GUI Building/Event Managing libraries 
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Tools Plus 2.6 

Tools Plus gives you the routines you need to create 
a professional looking user interface. 

Then we make it work. If s that sinfiple. 


Mow toe , 

CodeWarrior! 


l/Code Warrior i/aC-h+ |/PowerPC 

i^Syminik-c ✓ftiscnJ ^bmxO 

• Over 1 70 hig(v[ 3 owered ptml forget" roijitri^si th.il Eiuttmiic tind lh fiance: 
wont handJifig, windows, the loaf bar, floating patettE^^ cursors, buMons, 
picture buttons, sen >11 harN, rneni,i(s (pull-tlmvr>, hierarchical and pup-up), 

[ist Ijyxtrs, fiefds. Edit menu, clipboard Dynamic Alerts, and more... 


£asy hi i&irn and tisy ti t ase 
Suljstantial cxidc nxluttfon 
Dramatic code simplificaliun 
Signifiramly ]m debugging 
System h ai^ 7 i:onfip.itible 


rtJf ntjvice:, intemxdiirte and 
advanced ppogramniefs 
Kuns fast; iic'etfe linle memufy ur disk space 
Safer than boolbox louljnes 
Nhtj royatties 



Langoege 
OC/C++ 
O Pascal 
® Both 


m 

EIPg^lM 


^ Saues Time 
B Shoes Money 
M Easy to Use 
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Cheryl Lias, Kuri Sdmaickcr, iind l,:trry Tesler. Although the 
first native execution of a complete MacApp application was 
still weeks away, important technical Lssues, such as exception 
handling, were resolved. In addiikm, new technoingy such as 
lloating palettes and other enjianccnienLs w-ere merged intfj the 
Pascal framework. 

In the weeks following the Hack Session, the co-op 
mounted an incredilde effort lo get PowerPC native MacApp 
2.0.1 up t{) Ix'ta cjuality in time for the DevelojKT Conference. 
Support for ihe Metrowerks Pascal compiler was added. 
Several key managers ai Apple joined in and arranged a 
distribution license so that Language Systems ami Mcirowerks 
ct>uld include the PcwerPC native MacApp 2.0.1 on their CDs. 
(Special thanks to Kurt Schmucker for rallying this eftbrtf) The 
llrst develojx^r release of MacAppZPPC shipped on CcxleWarrior 
DK6 in May. An improved version shipped on DR7, hut owing 
to a CD pressing glitch, the project Mes and documentation are 
wrong; the correct material is availa]>ie online (see IxTow). 

About a dozen developers have already partially or 
completely ported their applicartons to Pow^erPC, and a few of 
them have already started shipping their native applications. 
Brian Arnold ported his own apidicaiion, Analytical", in under 
two weeks, and expects to ship by the end of the year. 

It is lityped that by January 1996, two versions will be 
ready: the final, stable MacApp2Prc, and a developer release of 


an improved version. MacTech hopes to rcptjrt further details 
in upcoming issues. In the mean time, developers who have LS 
Pascal can use the netlxjrne release f>f MacApp2PPC. For more 
information see tile MacA[)p2PPC web pages at: 

http://wvvwJumina.corn/arriold/MacApp2PPC.html 


Or, for anonymous ftp: 

ftp://ftp.rahuLnet/ftp/pub/arnold/macapp2ppc. 

To get on the mailing list, write to: 
arnold@lumina.coni 
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CRABB'5 

APPLE 


By Don Crahh 


Visually Speaking 



It's Novumher, 1995. Do you know 
where your M:ic development efforts ^ire 
heading? Will they be I inked, arm-in' 
arm, with Meirowerks, Symantec, and 
Apple, or will you set-off in the 
direction f}f one of the Mac's third parly 
niche tools companies, like Main Event, 
Pictorius, Main Stay, QKS, or Digitooi? 
Maybe you're even making the move to 
client/server developmcnl and are 
hunkering down with Oracle, 4th 
Dimension, Sybase, or even hilemaker 
Pro 3 0 (relalional) and the FM l^ro 
Server. And how' much of your efforts 
are to develop software for both the 
Mac and Windows 95? 

VisuAi. Basic 4*0 ¥oe th¥ Mac? 

No matter what direction your Mac 
development elToris will take you, 
however, they won't take you to 
Microsoft’s Visual Basic 4.0. MS has said 
“no way” to porting to the Mae, thus 
adding yet another brick to the wall 
Lsolating you from potential customers. 

Customers who miglil ljuy your 
Mac products for their Mac ghettos if 
they could somehow interoperate your 
Mac apps effectively with their huge 
installed base of Windows products, 
mast of which are driven by OLE, 

CiLstomers you might have reached 
a little faster if only you'd had tfic aid of 
VB 4,0 for the Mac to prototype and 


develop your Mac ai:)ps to live and work in a Windows world. 

But Mrcrosofi says ^‘no w^ay." They don’t want Mac 
developers pt>rLing their apps to Windows. They want Mac 
developers to dump the Mac and develop directly for the M bit 
Aid of Wm95 and N'L. 

The Importance of OLE and VB 

No matter how^ little you think of OLE 2.0, it's not going to go 
away jnst because OpenDoc: is a better SOM imptementalion. 
And Visual Basic TO is die raison d’tre of OLE 2.0. Vl^ 4.0 lives 
and breathe.s OLE. ft can create every kind of OLE server and 
container, including in-proc:ess servers, 

Witli VB iO, the OCX .sUmdard has arrived witli a flourisln 
VBX controls are automatic’alJy converted to OCX controls. The 
OCX language dialect is now VB and the runtime engine is 
shared by all MS Office 95 applications dial use VB. And every 
third part>^ addon module to Office 95. 

You cannot, however, create OCX controls in VB, but you'd 
l>Liy Borland’s Delphi 95 for thal (yei another top Windows 
development tool that will not make it to the Mac). 

VB 4.0 is also the detacto scripting language for Windows 
95, even if MS has not pushed it as such (nor bundletl it with 
the Win95 package as they should). As much as I love 
AppleScript and scripting on the Mac, VB 4.0 can do things that 
you can't do nearly as well with AppleScript (even with 3rd 
parly aids like Scripter and FaceSpan), like creating commercial 
applications or OLE objects. Visual Basic 4.0, in short, is a big 
deal. And it's a hAd deal for Mac developers (and customers) 
not to have it available for MacinUxsli. 

What’S Hot Ajioijt VB 4-0? 

VB 4.0 is w'hat I call a bridge language, ft can be used by 
customers used to write application or system macros and 
scripts, ft can fxf used by managers to create quickie apps. 


Aboui Don Crabb - Ekai is a contributing editor and coluninist for MacTecli, MaeWEEK, MacUSER, Mac/Chicago, MacToday, 
Win95llser. CcaTiputerUser, The Chicago Siin-Tiines Eeanires Syndicate, The Springfield Union-News, PC Magazine, and about 
a million other pubiicaticjns. Dtm welcomes comments at his Internet address: tieec@cs.ucIiicago.erlu. You can also check suit 
his Home page at http;//www.es.uchicago.edu/'“decc/. 
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And it can l:>e used by hard core application developers for 
eveiyihin^^ from simple proj^rams to advam!ed, enterprise-wide 
client/server applications thanks to its. different editions. 

PkOI liSSIONAL EDU ION 

The VO Professional Edition revolves around Ijuilding 
Windows .solutions quickly, making it a g<xxl fit for corporate 
IS deparrments. Coupled wrih the Visual Basic for 
Applications language engine (conimon aeross many MS apps), 
you get core developers able to communicate easily, 
leveraging their skills. 


Enterprise Edition 

For large programming teams building big applications, 
Microsoft provides Visual Baste, Enterprise Fdition. It enables 
teams to develop witii Visual Basic via the integrated Microsoft 
Visual Soiircebafe(TM) projectK)rienteci version control system. 
Tlie Enterprise Edition also feauires fast, dtrea acce-ss to remote 
client/server databases with the Rctnoie Data Control. 

Tl:ie list of what the Entetprise Edition of VB can dcj is long 
and impressive. Assuming you have at least half a brain, 
Microsoft expects that you can develop and debug a fully 
distributed a[iplication on a single workstation, tlien dynamically 
deploy it to network servers without much special help, 


You can partition your application into MS^standard 
reu.sable OLE business rule components, which makes it easy 
to reuse these components, across your net, with different 
development tools. You can also use the Remote Data control 
for high-speed access to ODBC data sources such as Microsoft 
SQL Server and ORACLE. You can also keep team projects on 
track by using the Visual SourceSafe version control system 
which works through MS's Solutions Frameworks 

Network for Dlsitubuied Services. 

In addition, and in no .small measure, Vi3 was designed to work 
with future Windows OS architecLiires Ciecluding ND, making it 
a very forgiving environment when MS pushes all of its Win^S 
ciLStomers over to WinN'f (Cairo) in 1997-98. 7'he Enterprise 
Edition of VB Louis itself as the first second generation 
client/server tool that encoumges developers to build scalable, 
maintainable, and widely reusable applications in a RAD 
environment. While that may be an exaggeration, the Enterprise 
Edition of VD is an imptjrtant tool tiiat will lie widely used by 
our Windows chums. 

And we have ntjthing like it for the Macintosh. 

Numbers Don’t Ije 

And that, like everything else in the VB sexmario Is had for us. 
Mt>re than two million copies of VB have been put into 
developers hands, making it one of the most popular platform- 
specific tools you can buy for Windows. Name one Mac 
development tool that has sold two million copies. 

The Microsoft Way 

Bottom line, Microsoft is not about to expand VB’s reach to 
help us. Instead, they're contented with keeping The Mae in its 
place,” as a senior MS offieial ttjid me recently. He went on to 
say that there was ""no chance at all," of VB being ported to the 
Mac, htxatise MS was "‘not interested long term in helping the 
Mac work with Windows.” In fact, since “we'd ratlier dial you 
guys just go away, why should we pon our be.st devtoob to 
you," he concluded 

Why, indeed? ^ 
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The OpenDoc Development Framework 


A modem framework for 
OpenDoc development 


DFVl-I.OPrNC FOR OpfjsBix: 

Tlic OpenDoc Development Framework 
(ODD is a modern object-orienied 
framework far developing* OpenDoc 
cxjmponenLs for Macintosh and 32-bil 
Windows platforms, h significantly 
reduces the work required to c:reate an 
OpenDtK: component editor, especially 
if you’re developing die part editor for 
Ixjth Macintosh and Windows. 

In ibis anicle, Fll provide you with 
an overv'iew of ODR Because DDF is 
loo large to address in one short article, 
Fm forced to condense and highligfiL 
My goal is to provide you w'ith an 
understanding of the problems ODF 
solves for you and how it solves ihem, 
and tfj give you a lasie what it is like 
Lo develop an OpenDoc component 
using ODR 1 assume some level of 
understanding of OpenDoc, but not 
much, so if this is your first exposure to 
OpenDoc, 1 suggest you dive in anyway. 


the better known frameworks include Apple's MacApp, 
Symantec's TCL, Metrowerks' PowerPlant. Mac'fech’s SpRx.'ket. 
and Paul Dubois' TransSkel. If you've used any of these 
frameworks, then y(>u proliably appreciate the lime and 
aggravation tliey can sjive you by presiding a solid foundation 
on which to build your application. Tliese fmmeworks not only 
provide yr>u with c'ode common to all M;icinu>sh applicalions, 
they provide you with an architectural framework that makes it 
easier to design your own application. If all goes well, you 
simply "till in the colors and conneti ilie dots," so to speak. 

The tJegree that “all gtx:s well" depends on the framework 
you clioose and your application's problem domain. The tnith 
is, any framework is designed to work well willi a specific 
range of application tlomains. If your application doesn't fit 
within that range, ilien tlie framew'ork will at best get in your 
way from time to time, and at worst be totally ikseless, Ytnj are 
not likely to have mucli syt:cess trying to write a 2K INIT using 
TO. or Mat:App. I don't consider this to lie a shortcoming of 
those frameworks; common sense dictates that one shouldn't 
assume a given tool is the rtgfit UKji for all jolis, big and small. 

Of course, a framework shouldn’t be a single tool; it should 
be a collection of tools that work well together. If the 
htimewwk is done well, some of these tools will he applicable 
to any prr>blem domain. Modem fcamew'orks are designed with 
tins in mind. PowerPlant, for example, is well suited for both 
simple “dashboard" applications and largc-scule applications 
that use multiple docTiment types, and pieces of the framework 
can he u.sed in pii>grarns that don't fit these domains. 


Why Another Framework? Wh\' ODF? 

Macintosh developers today have their Why ODF? Because even a fiexil^Ie framework like PowerPlant 

choice of several framework.s, S(>me of isn’t appropriate for all applications. First, developers need to 


Jim Lloyd - Jim lioyd has worked on an eclectic range of prcigramming piojtftts over the last 16 years, including image 
processing of radar images, tolleclion and analysis cT kinesiology data, income tax pa-paralion, relational database 
management using associate array processors, and natural sfKm h rtxTJgnition. Since 1992 he has focused on crass-platform 
ohjetTt-oriented frameworks. For the last year he has been a eonsultant to Apple Computer on the ODF pnjject, and he 
recently accepted an offer lo join Aj^ple full time. Strange timing, since Jim is in the pnK'ess of nu>ving fmm Mrjuntain View 
to a house he bought in San FmncLsco, Needlei^s uj .say, Jim is already looking forward to the clay that telecommuting at 128K 
or iTetter becomes a reality.,,. You're weltx)mc to contact liim at jim@melongem.com, or jimJloyd@powertalk.applG.Com. 
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delivt:r ihcir appltotions on midtipk platforms, inclLRlini^ 
MicTow>rt Windows. Second, OpcnD<K‘ intrcKliices a new of 
requirements that may be very difficult U> fulfill unless the 
requirements are considered in the initial design of tlic 
framework. ODF addrc.sses brjth of these issues. ODF is a 
mtxJern fntmew'ork designed to be flexible and robust, to tx.^ 
cros.s-piatfbrm, and to provide complete support for 0]X*nl>tx\ 

ODF is a cross-platform framework because its APIs 
abstract away the particulars of t'^ach operating systems' specific 
data stmcUires and APIs. ODP defines platform-independent 
Aids, and implements these APIs on multiple operating 
systems. Developers who program to the frameworks APIs 
exclusively should be able to move their applications to evc‘ry 
operating system supported by the framework by simply 
recompiling their cotie. ODF nirrently suppons the Macintosh 
OS for both 68K and PowerPC, and supports Micr<tsofl 
Windows tor its 32-bit operating systems, Windows 93 and 
Windows NT. 

ODF includes a rich foundation of subsystems organized 
into two layers; the Foundation layer and the OS layer 
Subsystems in the Foundation layer have no dependencies on 
llic subsystems in the OS layer, and are generally asefoi for a 
veiy w'ide range of a|>piicalit>n domains. Subsystems in the OS 
layer provide npc'rating system .services such as files, restnirces, 
and graphics using piatformdndependem interfaces. 

On top of these iwo layers we add a third layer, knowm as 
the Framework layer. The ODF Framework layer i.s .sjieciric to 
building Optml^K’ component editors, and is designed to solve 
the proi>lems of that paiiiciilar domain as well as possible. 
ODF |>rovides full coverage of the OfK-nDcx APIs, and ctjmxily 
implements the human interface .standards. If you use ODF to 
develop your OpcnD<K part, you1l need to do less wtjrk to 
make your part functionaL You'll als«) save yours4.Hf much of 
the additional effort required to make your pail inlcTopemte 
correctly with other parts, as well as the effort required to 
provide the ctiarect human interface Ix^havior. 

An extra Ix-nefil to using ODF is ilial it pnwkles some of 
the Ixst sample code forOpentikic parts that you cun fmtl. 'file 
ODF examples range iViun the minimalisl ODFHe I lo part, 
which is our inteqxetation <jf ‘'Hello Workf, implemcnied as a 
part, to ODFDraw, a cross-piatfbrm drawing part witli ll< Kiting 
palettes for drawing tcxils, pattern selection, and color .selection. 
Of greater significance, ODFDrav i.s a robust container part for 
embedding other parts. ODFDraw has been the comaiiier of 
dunce for OfKmDcx- demonstrations for much of the hist year. 

ALso included among tlic ODF examples are a biimup pan, 
a ckx-k part, a intrvic pait, a table part, and fitially the “beetKT” 
[>art, which will play a big role in this article. 

i:xTKNDfNG The Beeper’s FtTNcnoNAmr 
ODFBeeper is a simple button part that can play a sound 
rescjurce, ODFBeeper, as tlelivereti on previous releases of 
ODF, supports drag-and-drop so diat you can change the Mnmd 
that is played by dropping a .sound file onto the button. In this 


article, we'W extend tlte fieeper pari to al.st> execute any 
compiled Apple,Sciip! drtipped onto it. 'riumks to Fric Jackson 
for coming up wiil'i this idea and drafting me tcj mnk on it witJi 
him at a recent ODF Crxling Retreat. t^Tic and 1 did a quick 
hack so that the Beeper would exeeule scripts insfead of 
playing a sound. It occurred to me later that with only a little 
more effort, the Beeper could do either sounds or scripts. The 
code presented in this article docs both, anrl uses an 
architecture that v^oiM make it ea.sy to add tHher kinds of 
actions liesides .sounds and scripts. 

In order lo ,sc‘e where we are going, let's first look at a 
.screen snapshot of the final pnxluct: 


^ m Document Eilil Arrange Size Options iLtincfoio^ 



User Interface fsacb as there Ls) 


This semen shot slicws an ODFDraw tkxitmcnt Ixfing used 
as a generic ctmtainer. It contains two ODFficeper j>arts 
embedded inside it. Conveniently located nearby are some 
sound files and some compiled ApfileStripl files. 'Ilie user can 
drag any of these files onto eillier ol the buttons. Clicking on 
the button w ill fx^rlbrm the action a>rresponding to the last file 
dn»pjK*d onto the bLillon. Changes to I he whole doniment are 
persistent. The user can use the capabilities of the container 
appliniiion lo rearmnge the buttons, and can change the action 
of a billion by dropping a new script or sound file onto the 
huttem. Saving the document .saves all of the slate, so the 
buttons will lx* in the same kx at ions and [xiTorm the siune 
actions ihe next lime the dcxiimeni Is opened. 

Dkwloping a Part Editor 

r)eveU>ping a pan with ODF is much like developing an 
appliaitiun witii an ap[)lkalion framework like Foweri^bnf, TCX 
or MacApp. You am use your favorite C-»-+ pnjgramming icx>ls, 
inckiding Apple's, Meirowerk.s' and Jiymantec's development 
environments, and oilier Kxils siu^h ;ls Object Ma.ster fioni ACIDS 
and 11ie Debugger fixjm Steve jasik. I'he ODF view system is still 
evcjlving, so currently there are nt> visual tools kx laying out your 
f)arFs views, bill visual tcxrls for C.1DF am under development. 
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For the purposes of this article, 1 started with the source 
For the ODFBeeper example pan included with the 1.0d9 
release of ODF, which was provided on the OpenDoc DR3 CD. 
If you liavc a source code disk subscription, the project and 
source for this extended example will lx: on your source code 
disk, but you’ll still need the QpenDoc DR3 CD if you want lo 
fuitlicr cnhant:e the example. If you don’t have a soukc code 
subscription, keep an eye out for the OpenDcK DK4 release; 
ODF 1 .(XI11 will be on that CD and will include the extended 
ODFBeeper example. 

liy the way, there’s no way that MacTech could publish all 
the source code necessary for tliis sample (and you wouldn’t 
want to try to type it all in!), so I won't be showing t:ompleTe 
source code listings in this article. Instead, I'll show the 
relevant snippets of code as they are discussed. In these 
snippets, I'll sometimes omit code not direedy relevant tt^ the 
discussion by replacing several lines of code with a single line 
containing an ellifisis and optionally a comment, like this: 

//Lrrelev'am smJTomittttl 

ODF paas can lx? developed for either PowerPC or 68K using 
several different environments. For this article I used the 
PowerPC compiler in the CW6 release of Metrowerks 
CodeWarrior Golii and haven’t yet tested the part with other 
environments, but you c:an expect the part to be l^uildable witii 
all SLipported development cnvinmmenLs on the 01(4 CD. 'I'he 
f{)IIowing is a snapshot of the ODFBeeper CodeWarrior pnijeci: 


OPFBeflper>Mm,ir 


Fil# 

Code Data M 4 


V Of>FB««t»«r 

OKj ZK\ « Q 

St 

Acticms.cpp 

1 45721 604i * 0 



j 31321 22391 • • 0 


Bwp^rS^l.cpp 

652[ vm\ # • 0 


SOMBfr^ptrepp 

452 I 471 1 * *0 


BetptrP^r t .rsre 

1 n/aj n/ai 0 


l> ODF 

IKI IBOJ ^ 


OpMDw 

i ol 0 : 0 


B RiHitfiM Libraries 

1 todjd t6id 0 


b ^stem Libraries 

.. 01 . oi a 


20 filvCs) 

1I4IC 211IC 

m 


ODFBi^ier Project 


Tlie ODFReeper example uses four source files. 
BeeperPart.cpp implements the classes GBeeperPart and 
CBeeperFrame, which are subclasses of fhe ODF classes 
FW_CPart and FW_CFrame respectively. BeeperSel *epp 
implemenLs the CBeeper Select ion class, which is a suWass 
of the ODF class FW_CSe 1 ect i on. Act 1 on s * c p p implements 
the classes CAction, GSoundActioo, and CScriptAction, 
all of which are completely specific to ODFBeeper; ODF itself 
know's nothing alxxii aciions. SOMBeeper, epp contains the 
C++ bindings for the r€t[uired SOM subclass of ODPari, which 
won't Ix" diMiissed in dus article. In addition, ODFBeeper itses 
die resource file BeeperPart, rsre that contains a typical 
assortment of icoas, strings, eu:. !t w^on't lie discussed further in 
this article citlien 


ril now pniceed to describe the source code in the dirce 
source files Actions, epp, BeeperPart. epp, and 
BeeperSel-cpp, in that order. However, before discussing 
die Action classes, I think it would be worthwhile to partially 
discuss the CBeeperPart class. If you are familiar with the 
Model-View-Conlroller architecture from Smalltalk that has 
tx-*en adapted in various incarnations in tnost frameworks, then 
you can consider the Action classes to be the Model, 
CBeeperFrame to be die View, and CBeeperPart to be the 
Controller. Since the CBeeperPart is in conLr()l, it is 
worthwhile starting with its relationship to the Action classes. 


CBeeperPart 

Here is a partial definition of the class CBeeperPart: 

clasE CAction; //frrrward tfcctaiion 

class FW_CLASS_ATTR CBeeperPart : public FW_CPai:t 

I 

public: 

... a constructors, methods tnhciitcd Grom FW_Ci*jrt 

//- 

// New API 
// 

public: 

CAction* CetAeiionC) I return fAction: } 

void SotActiontCActlon* action): 

public: 

void DoActionf); 

//--- 

// l>atu Members 
// 

private: 

CAction* £Action: 

h 


In ODF L0d9, CBeeperPart had u single data iTiemtx:r diat 
was a handle to the sound resource to play when die button 
wa.s clicked. Since we want our new pan to perform different 
kinds of actions, weVe changed the data member to be a 
pointer to an abstract class CAction. Well use the Action 
abstraaion to minimize die dependencies of CBeeperPart on 
the details of implementing sound and script actions. 
CBeefierPart know.s alxitit the existence of abstract actions, and 
has a very simple pruttx’ol for actions wbic'h include the ability 
to get and set the current action, and to forward a recjue.st to 
apply the action to the current CAction objea. 

CAction 

Let's now look at the definition of the abstract class 
CAction: 

class FW^CUSS_ATTR CAction 
t 

//- 

fi 

public; 

CAction 0 : 
virtual '^AcLlonO : 


if -— 

// Action proitxroi 
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Fast remote internetworking 
in a s/ng/e box. 


^ Shared Access to the Internet 



^ E-mail 

Streamline communications 
With enterprise-wide E-maiL 


ExprcsisRouter DDS 


Your whole department or organization can connect to 
the Internet—full time or just when you need to. 


^ Telecommuting 

High speed access to 
the entire office network. 




^ Centralized Databases 

Access or update information 
from any point on your Wide Area 
Network. 


£n press Rmiter-tSDN 


^ Videoconferencing 

Close the gap between 
distant sites with LAN-to-LAN 
videoconferencing. 


► Fast Fiie Transfer 

Transfer files at speeds up to 
1.544IVlbps—10 MB per minute. 


EvprtnsRfiUters 
whli integrated 
Interfaces 


What makes the ExpressRouter the best choice for your Wide Area Network (WAN) needs? 

• Built-in WAN interfaces for Frame Relay »ISDN, Tl, and 56Kbps DDS. 

• Expandable architecture that supports up to 3 high-speed WAN ports. 

• Built-in support for AppleTalk, TCP/IP and Novell IPX LAN protocols. 

• Interoperability via PPP 

• Support for SNMP and Telnet management standards. 

• Powerful, easy-to-use auto-dialer software designed for the Macintosh. 



Engage Communication, Inc. 

9053 Sequel Drive • Aptos, CA • 95003 

Tel: 408.688.1021 • Fax: 408.688.1421 • E-mail: sales@engage.com "WWW: www.engage.com 












WITHOUT PROGRAMmiNC! 


PotchNorhs Pro 

Patchworks Pro lias jiiany options, but only one function- to 
create small, stand-alone Updater Applications which field- 
upgrade your pnxlucts to newer versions. Updaters can be 
freely and safely distributal online, since they are only of use to 
end-users whoVe already purchased your software, 

UPDATERS ARE FAST 
SAFE St EASY FOR EIUD-USERS 

Your end-user just downloads and runs the Updater. 'ITie 
Updater prompLs the user for the original software via a "Get 
File’' dialog box (if not in the .same folder as the Updater). 

When the user clicks the ’"Update” button, the original software 
is updated immaliately, 
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UPDATERS ARE CREATED IIU MiniUTES! 

Wlw tie-up valuable programming time building updater 
applications? Just fill in a dtalr^g, and PatdiWorks docs the rest! 
Since there's no coding or scripting, no bugs arc introducaf 

* Works with apps, INlTs, edevs, fonts, drivers, etc* 

■ Works on resource aitil/or data forks 

* Full support for PowerPC and fet binaries 

* Upiiaters support mtrltiple "old versions” 

* Prc.scrvcs personalization data (name, serial #, etc.) 

* Customizable end-user intcriacc 

* Uptlatcrs cati execute custom CODH resources 

* Intelligent diff-ing produces small Uptiaters 

* Distribution of Uixlatcrs is unrcstrictal and royalty^frce! 

MOW AM IMDUSTRY STAMDARD 
AFTER FCXIR YEARS OM THE MARKET 

PatchWorb Pro is uscti by Macintosh puhlisliers such as: 

Apple Computer, Adolx: Systctris, MacroMind, Now Software, 
Symanicx, WordPerfect, and many more. Pricing begins at Sl95, 
Download a fully-functional trial version from our wel> site: 
1uip://www.broadcastsoft.com”, or call us at (^07) 241-030S. 


BtfO&dCast Software Corp 

East: 407-241^308, Fax: 407-241-3195 
Wesi: 505-3174)429, Fax: 50^317-0430 
Net: htipyAvww.bmacka<aj^ 

Fjiiail; inlu@broackasLsnftxoni 


BraadCast 


// 

public: 

virtual void TltterualiKetKaviroument* ev, 
ODSloragiillnit* storage) ^ Or 
virtual void Externalise(Environment* ev, 
ODStorageOnit* storage) “ 0; 
virtual void DoIt() “ 0; 


Action objects assume a two-step initialization; they are 
aeated In a default stale and then initialized from a storage unit 
with the Internalize tncthixl. They also know how to save 
themselves to a storage unit via the Extornaiize method, 
and to do their action via the Dolt method. In diis alistract 
base class, die iliree rnetliods other than the constructor and 
destructor are pure virtual metliods. Subclasses of CAction 
must provide a default constructor, a destructor, and 
miplementatioas of the three virtual methmls Internalize, 
Externalize, and Dolt* 


CSoundAction 

Let's now look at I he implementation of the two Action 
subclasses. First, the definition for the class CSoundAction: 

clttss FV_CLASS_ATTK CSourrdArt 1 on : publir CAction 

I 

a— - 

// 

pub]it I 

CSoundActionO : 
virtual “CSoundAcr.lon() j 

stfltlr; FW Booloan IslnStorage ( 

Environment* ev, ODStorageUnlt * storage); 


//--- 

// Atiiim pniltx'ol 
// 

public; 

virtnnl void Intenmlize(Environment* ev* 
ODSlorageUnit* storage): 
vinual void Externalize (Environment* ev* 
ODStoragellnit* storage) ; 
virtual void Dolt (}; 


//- 

// Mvaic tmpIcmtnnMkm 
// 

private; 

void TnierritillzeSoundtEnvironiient* ev* 

ODStorageUnit* atorage); 
void lnternallzGSoundFlle{Knvironmont* ov* 

ODStoragellnir* storagol: 

Randle fSoundRandies 

h 

Ihis claas is a simple iinplemcnliiLion of the cLiss CAction, 
so the tx)nstnutor, destructor* and three methods Internalize, 
Externalize, and Boll are dictated by the base class* 
CSoundAction adds a puldic -static methcxl TsTnStorage, two 
implementation method,s for inlemalizing from specifit' sound 
fonnals, and a data member for storing a sound liandle. Let's 
look at die denniti(>n.s of ihe methods of this class* beginning wit 
the implementation of the Internalize meih<Kl inherited from 
CAction: 


C^umlAolon: intcnmlfee 

void CSoundAction:: Internal IzctEiiylroiiMuiJt* ev* 
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ODStotag^Unit* storagi^) 
FU^Boalean InLcrnal 1 Kf^d - FALSE; 


if (storage‘>Exists(ev. 

kODPropCoBtettts* kSoundScrapKi nd . 0)) 
I 

// Mac snd ■ in Scrap 
storage >Fqcu‘i (ev. 

kODPropContents* 
kODPoslIndcf 1 nedt 

kSoyndScrapKlrtd ♦ 

0. 

kODPosUndefined): 

TnTernaUzeSonnd(ev, storage): 

) 

else if {aLorago->K5<ists(ev* 

kODPropContents, kKotmdFlleKiiid, 0}) 

[ 

// Mac injunii file 
storage->Fc!Cus(ev, 

kODPropContents* 
kODFosilndefined, 
kHFSFlavorType. 

Oh 

kODPosUndelincd): 

rnteniali^eSonndFiie{evH storage); 

I 

1 


This cocte cx^imines the Httiragt! unit for the existence of 
either a sound resource (OSType ^ snd ' ) or a sound file 
(OSType 'sfil' ). If either is found, the code focases the 
storage unit and then calls one of the two private member 
functions for reading the spetihe: data type. 

By the way, the constants kS ound S c ra pKi nd, 
kBoundFileKind, and kHFSFlavorType are siring^s defined 
in the header hie lieeperOef h using a naming convention agreed 
upon by the Openf)<x: implementors (Apple, IBM, and Novell): 

(^define kill''SlTfjvocTypo ”App1 n:OSType:Scrap:hfs " 

^define kSoundScrapKind '’Apple:OSType:Scrap:snd 
jffdefine kSoUndFileKind ’’Apple:OSType:F 11 eTypeiafil'* 


If Internalize detects a sound resource in the scrafc h calls 
the method InLernalizeSound: 


r3tiimilActioii;:fntcniaJizcSoii[Hl 

void CSoundAction;:InternalizeSound[Environment* ev, 
ODStorageUnit* storage) 

[ 

// Assume the storage iinit is already focused 
unsigned long size = sLorage-^GetSize[ev); 
if (size > 0) 

I 

FW CAcquireTemporarySysteMiaiidle liandletsUe); 

FW CByteAxray byteArray; 
aLoraa<?->GetValije(ev, siscn byteArray); 
by LeArray, CopyBuffe r (handle. GetPoititer () * size) : 
fSoundUanclle = hand 1 e,GetPli^tforiiiHandle(): 
handle.Orphan[) ; 

J 

) 


Inuerna 1 izeSound assumes the entire content of the 
propeny value is a sound re.source. It allocates a handle of tlic 
appropriate size and then reatls the data into the handle. 
Finally, it stores the handle in tlic fS oundHandle field. 
Ixxiking at tlie code, we see that a little more is going on here, 
which is wonh explaining in some detail. 


SOLID SOLUnOlU FOR 
ELECTROnilC DISTRIBUTION 


Broadcast 

Broadcast is a highly secure, patent-pending system for safely 
distributing locked’* software online, or on CD-ROM, Ihis 
cutting-edge technology was developed by the same 
engineering team behind Patch Works—our tool for creating 
online updaters that's become an industry standanl used by 
clients like Apple Computer, Atlobe Systems, MacroMind, Now 

Software, 
Symantec, 
and 

WordPerfect. 



BROADCAST IS EASY 
FOR YOU AMD YOUR CUSTOIVIER5 

In seconds, Broadcast .securely locks your product into an 
Unlocker application ihat ran l^c safely distri[)utcd to tlie 
public. *lb buy your protiuct, customers simply run the 
Unlocker— then cither call you. or complete zn t)nscreen order 
form that's emailed or fexed to you with a unit|ue “control 
number” (and encry'pted credit card data). 

Your staff processes the credit aid, registers your new u.ser, 
and provides your customer with a password based upon the 
control number lb unlock your software, the cnsiomer enters 
this password in the Unlocker 

BROADCAST IS IIUEXPEMSIVE 

We areni resellers or tlisrributors. Customers buy directly from 
you, and we take no percentage of your sales— just a .small fee 
per transaction. In faci, Broadcast isdisiributed for free. Wre 
betting you'll tjiiickly use the free password points that come 
with Broadcast, and purchase more as your sales soar. 

Well even help attnia customers by advertising your products 
for free on our ’^Software Unixixed” internet mall. 

GET THE WHOUE STORY 

We invite you to learn more by visiting our internet web site at 
“http:/Avww.broadastsoft.com”, aiul download your free 
Broadcast Staner Kit, or email us: “info@broadcastsofixom” 


IniailCast 


BroadCa^ Softimre Corp 

407-241-030S, I'ax: 407-241-3195 
West: 503-3174)429, M 503-317-0450 
Net: htip:/Awvwbix)atlcastsofi.a)Jii 
Email: iafcj (ffibrmdca.SLSoit.com 
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Presenting the extra-strength text editor. 



If you previous versioas of QUED/M 

were powerful wait until you program with 
QUED/M 2.7, loaded with these new pain- 
relieving features; 

Integrated support for THINK Project 
Manager’” 6.0 k 7.0 

© THINK'" debugger support 
© CodeWarritjr’” support (now iTs 
easier than ever to program for the 
Power Macintosh^'!) 

© MPW ToolServer''' support 
© PopUpFuncssupport 
© Frontier"" Do Script support 

For quick relief, call 
800-309-0355 today. 


Of cx>urse, QUED/M 2.7 stiU has all Ihe features 
that make it easier to use than any other text editor; 

© Macro Language lets you automate 
tedious tasks 

© Search and Replace through multiple 
unopened files and using GRFP 
metacharacters 

© File comparisons using GNU Did 
© Unlimited undos and ledos 

© 10 Clipboards that can be edited, saved, 
and printed 

© Customizable menu keys 
© Text folding 
© Display text as ASCII codes 
© Plus many more features! 


Get even more relief: Try QUED/M 2.7 now for just $69! You’ll get a 
30-day money back guarantee too! Call now to order. 800-309-0355. 


Btf fniiinftiwlji [V JijjBtfWf cf'HKtr 


N6IIS 


107 5. Caim Ave, • Mwk CA 92075 * Td (619) 4S1-1477 ■ to (619) 4^}-bJ54 Sofi WU re I n C 


To ullcx^tc the handle, the tx>de uses an iastance of the das.s 
FW_CAcquireTemporarySystetnHandle, which is a ti^suutve 
acc|uisitt(m hel[)er object Lliai alltKiues a "remporary" handle. The 
handle i.s coaskiered to be temporary Ixx'iKise oiiless ifisiniiied 
otherwise, the liandle will be dispased when the helper objcxri 
goes out of scope. On Uie Macinio.sh, the constructor of 
FW_CAcquireTemporarySystemHandle will allocate a 
handle in Muliifinder temporary memory (thniwing an excejHkm 
if the alkx’atkni fails), and then kx’k the handle down in memory. 
On f>ther platforms, it does sometiTing equivalent. 

The FW_CAcqu i reTemporarySystemHandle destructor 
will unkx;k ilie t^bjcct, and optionally dispexse the handle. 'Die 
default lx‘havior is to disfxjse llie handle, tml caliing the Orphan 
meiluHl instructs the heljxr object to not disptise the (landlcc This 
may seem a little involvetl, bur it is a vety convenient idiom fur 
alkxtttion of restjurcc^ (like memory) that must Ix^ disposcxl if an 
exception is thrown IxToa* the resource is uHupletely initialized. 

In CSoundAction : : Tote malice Sound, we am a,ssunie 
that any of lire thae linc-s of code starting with tite cull to the 
methotl GetValue and ending with the call to the methtxl 
GetPlatfornillandle could thrown an exception. In actual hut, 
w ith I lie current impiemeniations of these functioas, tally the 
Get Value method could thrtjw an exception, but in this case it 
fiurts nothing to Ix^ tx>aservative. 

ODF provides a range of utility functions and helper 


objects that make it ptxssibie to write jX)rLitt>Ie code tliai works 
witfi CXI eptio ns correctly. In the case of 
CSoundAction: : Interna 1 izeSound, the advantages of 
the plat for m-indcpcndcnce of tlic lie I per olijects 
FW_CAcquireTemporarySys temHandle and 

FW_CByteArray aren't fully rcalizetl tK'Cause the function as 
a w’hote is making an assumfition sy>ecific to ihe Macintosh: 
'snd ' resources exist only on the Macintosh, With a little 
extra effort, it w'ould Ix! p<js.sil>le to t reate an ab.straction for 
sound data tliat would work tni IkjiIi Macintosh and Windows. 
Such a class whll likely make it into ODF someday; in liie 
meantime, we leave it as an exercise for the reader. 

Let’s now look at the inetiuxl to internalize a sounrt file: 

CSoundAciion:: Jnk malii'cScjujidiJ^ilt: 

void CKoiin<iActlt>nr: IniernalizeSoundFilefCnvironment * €V, 
GOStorageUnlt* Storaj^e) 

I 

// Storige Uiiii aircatly he Fucustxl 05 HBFlavor 
unaigned long bfsSize - ntorage?XkjtSt^.ctcv): 
if (hfsSlze > 0 ) 
t 

// (irt Ihc HFS Ibvor 

HFSrlavor hfslnto: 

FW_CByteArray byteAcray: 

storage->GetValue(ev. sizeof(HFSFl«vor). byteArray}; 

byteArray.CopyBuffert&lifaTtif 0 . sizeof (HFSFIavor)): 

// CTcate ptajform fik spec 

FV_CFncSpetiricaii^jri fiieSpecthtsInfo.fileSpec): 
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Nowyour computer 
canbebotha 
Macintosh and 
a UNIX workstation. 



The Mach’'®" operating system combines the high-level 
hinctionality of a networked UNIX workstation with 
Macintosh’s wide array of applications. 


is a EJerkeley 
BSIJ UNIX tiiat runs m 
Iho Classut to the Power 
Macintosh, Including 
PowerBooks ajifJ Duos! 

So ill addj Lion to ail of Liio 
casy-to-usn applications 
that make Macintosh 
oriH of l.hn most person¬ 
able computers around, 
you get a MACl Mmefl 
UNIX with pre emptive 
inuttitasking. 

Mach^'^'s strength 
lies in Uie wi^y it extends liie Matin 
Operating System with UNIX networking 
and sotlwaw? develupmenL bols. Tlie 
MaeintnsMJNIX integration is so strong 
that you can even use Mac prugrains & 
iitililics on UNIX data, and UNIX programs 
& ntiJities on Mac files. 

Full internet protowjl support ensures 
fast easy client and server NFS. electn>nie 
nial), mid file transfer between the Mac and 



Any NFS server tiui be usifd to store Mecinlosh 
ies- Uscis cen access (hem by dotjUe clidwiq 
05 arilhp local isk 


ail TCP-based entities 
on your network. 

The UNIX software 
development system 
includes the GNU C and 
C-i-+ eumpilcrs and 
libraries to let you 
(rreale new applications 
or port existing ones. 
The Molif Loulkit and 
suite of X clients and 
X client libraries make 
developing distributed 
applications a broe/ve. 
And Ihncjtfs high ix^rformance X Server 
lets you use your Macintosh or Power 
Maiuntosh ns an X terminal. 

Join the many satisfied users of proven, 
reliable Machi^ UNIX, and start turning 
all of your Macs into open systems today! 

Far more infomiatioii., or to order 

call 1-8004-MACH-10, 

Interne U mfo@tenon.com 
hllp: /Avwiv. lenon.com 


TENON 


Nm Dim^msians in Personal 
f/ ,M,— s.'sTtVs : Watefrtfwm 
Teoon Inlersystenns 1123 Chapala Street Santa Barbara, CA 93101 Tel: 805-9B3-69S3 Fax: 805'962-8202 

OtaSH THncn IniHKySlHra. Fhij Tavii I rVlMfJ ml MO KlCKmflWj (sl lOfWI rrtigiSyElBrrE OwMiCJ. 

F^twiflf FW« 4 iriU 4 lii ttfki titi-n«f IraMuntiks u( CWHiJiw. fc<t IJNK id Q iflfjjsrtwffjH 1 rmli»rnn* h t« LJriorJ f>uiic« flnri rrtlift ixuiirtRfi. iconacC tSiCiJUhOly K’n'jjrr’' JWptu f;c<rtTnr^ i-rMtad 


// 0[>en the rewntree file 

PW_CKesoutcePlle rouourceFlle(f11eSpec); 

// Gci myQx. iIh: rirsi) MMind rcsouroe 

const FW^ResourceType resoaxceType = ' end ’: 

const FW_ResourceId resourceld - 1: 

Handle sound "= : iGet 1 ItidResourcel resourcelype, 
rcBotirceld) ^ 

If t:iound 1= NULL) 

I 

// if suct’cedcti, dciach tJic handle and keep it 
(;DetachResource(sound); 
fSaundHandle “ sound: 

] 

else 

1 

// No sound resource loaded, throw an exceptiun 
FW_THROWCFW_XResourceNotFDUtidtreiiourceFiic. 
resourceId* 
resourceType)); 

1 

I 

1 

Int ernalizeSoundFile is similar to 
InternalizeSouad, Itie difference Ls that instead of gelling 
the sound resource directly from the stomge unii, it tnsiead gets 
an HFS file speciricaiion from tlte storage unit. It then uses this 
file specification to open the file and grab the sound resoiirt:e 
from the file. *rhe code here is a bit eomplicated because 
sound file.s donT use fixed resource IDs, so the code must look 


for any sound resource. Unfortunately, this is a function that 
we don't (ycU) provide in the Resources suksysiem of ODF, so 
we have to resort to direci calls u> the Macintosh toolbox 
resource manager. The good news is that ODF dfjesn’t get in 
tlie way of doing this. In fact, it is still convenient to use an 
instance of the class FW_CResourceFile to open the file, 
since it will assume responsibility for closing tlie file when it 
goes oul of scope. So, we use ODF to create and open the 
resource file, and then use the twti toolbox calls 
Getl IndResource and DetachResource to gut tlie sound 
resource from the file. Since weVe taken direct responsibility 
for reading the resource, it is our resprinsibiliiy to handle any 
errors, which we do by thrf>wing the appropriate exception. 

By the way, a new feature^ already added since ODF 1.0d9 
will make it simpler to throw standard exceptions. Instead of 
writing the above FW_THR0W statement, you could instead 
write sometliing like this: 

FW_FaiiOnExrort: : ResEririSrO ) ; 

WeVe seen how to internalize .sound re.sourcc.s, now lefs 
see the cxKle to externalize them: 

(Jkmnd Aa w m :: Extemaiize 

void CSoundActioti: :Kxteriiall;fic(Erivironmenr' (?v, 
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h(3i it comes lu text editing have you 
hopedforalittlediviDeinter- 
if it hasn’t arrived yet 
should be coasidcring PAIGE. 

Whether you're developing die next “killer" inter¬ 
net a{^iicatiun. buildit^ a euxtum pubiLshing tool or 
adding advanced word processing to your CAD pro¬ 
gram, you can’t ignore die quality of your text editor 

With PAlGi; you can create the most sophis 
licaled text features in die business. Including: 

• Stylized Ibxl 

• Text Wrapping 

• Einbeddd Objects 

• Shapes & Container 

• Virtual Memory t 

•Style Sheet Support * 

• Muiti-lingual Capable 

• Portable C Code 

• Royalty Free 

PAIGE is written in (xirtable C and uses no global 
variables. Machine specific code is raimmized to 


ensure a consistent API 
for all platforms— 
simpli^g multi- V. 

platform develojimenL 
This strategy allows 




you to move your 
iqipllcation toother 
platforms wiiilei 

_p_application compatibility. 

To simplify die iiitegralioii of PAIGE into Windows 
(l6-bit, 32-bit, ‘95 or NT) applications, our library 
ships as l)[.Cs and can be used as a custom control. 
Combined with the message based demo source code 


and simple introduction guide, PAIGE gets programmers 
up and running quiddy. 

So why ^ould you buy PAIGE? TIME. Programmers 
can't afford to reinvent the wlieel vdien inqilenieiitiiig 
advanced text features within dieir appllcidlons. 

join the hundreds of m^or software publisliers 
using PAIGE as their total text solution. For a complete 
technical and pricing summary, or to request our prod¬ 
uct demo, contact the DSI sales department today at 
800-327-6703 or 360-573-9155 



Datal’ak Software Inc. 

?317 NE Hwy 99, #C • VancoMvtf, WA 98665-8900 
Bus: (560) 573-9155 • Fax; (360) 573-9269 

Internet: 76424.3027@cttinpuserve.com 
www.teleport.com/~(latapak/ilatapak.htnil 
AppleLink: U0142 • AOL; DATAPAKt 
• CS: 76424,3027 


“Say, nice job brother John. Now could you make it a three column 
format with digital memos embedded In the text stream?” 


ODStorageUnit* storaj^e) 

// Assume we 'it hxnjsed on the ecviroit property 
storage->AddValue(ev, kSoundSerapKiad)j 
if (fSoundHaadle 1^ NULL) 

FW_CAcqulreLoekodlSyiiLt‘tn3kndle lock(fSoundHaadle); 
FW_CliyLt?Array byteArrayf *f SoundKandle > 
[‘‘WJMemoryHanager r; 
GetSysteniHandleSize(fSoundHatidle)); 
storage->SetValueCev. byteArray): 

\ 


Externalize .simply :Klds u sound scrap property value, 
and tiicn writes out tfie st)nncl handle. Since the handle needs 
ro l)e locked in cjrder to be written out, we take advaniaire of 
llie FW_CAcquireLockedSystemHandle helper object to 
kx.’k the oljjeet and assume responsibility for unlocking it. The 
re.st of the code sJiould be seif-explanatory. 

Finally, we round out our implementatitm of 
CSoundAction with the Dolt method; 


CSoiindActioaiiDoli 

void CSoundAction::Dolt £) 

I 

if (fSoiindHandlp. i” KIILL) 

i 

FW_CAcquir4^Locked £iysti?mHandie lockCfSoundHandle); 
;:SndPlay(NULL. (SadListHandle)fSoundHandle, TRUE): 

I 

1 


Here we simply lock llie handle with a liciper object and 
then use the toolliox function SndPlay to play it. What could 
l>e easier? 

CScriplAcliiin 

The implcmentaiion t>f the class CScriplActlon has a lot in 
coimnon with the class CSoundAction. Compiled scripLs, like 
sounds, are stored in memory as relocatable blocks accessed 
via handles, and are .stored on disk as resources in the resource 
fork. Tlic code to internalize and externalize a compiled script 
is tlietefore similar to the code to intenmiize and extemali/e a .sound 
resource. 'I'he only significant difference is in the implementation 
of InternalizeScriptFI l.e, so for the sake of brevity, well 
skip the code for CScriptAction: ilnternalizeScript and 
CScriptAction::Externalise. 

eScript Aa ian:; t atf ma li zttScriprFi Ic 

void CScriptAr.t i nnt i TntGraal i zcScrip iFilc (EnvircmiDGiil* ev , 
ODSlarageUriif titoriige) 

[ 

// Storage Unit should aJrtady be J'ocustd on llFSl^bivor 
unsigned long hfsSize ^ storage->GetSlze(ev); 
if (hfsSize > 0) 

1 

//Gti ilie HFS llavor 
FFSFlnvor hrslnfo; 

FW_CJiy teArray byteArray; 

sto - >eetVa iue {ev, g izeof (HFSFlavo r), byteAr ray); 
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bytcArray .Coj>yRufft!r<&hfsTBfo, sJzeof (KF-SFIavar)): 

// ^takc ihc fik ^-ciTicatkin 

FW_CFlieSpecificatioti fiieSpec(lifBlnfo.fileSpec): 

// Acquire in upened resuufix 
// will be ckKkL'd iiitumitkilly 
FW CRfiHOdrceFilfl r^nourceFite(flleSpec) ^ 

// Acquire an opc'nctl rcsmiftc, 

// will be released auioniaiically 

FW^CResoutce resource(resourceFlIe, 128* *scpL'); 

// C>>py ihc rcsouiec hajidlc 
fScriptHandle “ FW CMeoioryManager:: 

CopySy'Jt.fimHandle(reBDiircie.GetKandle{)}; 

1 

1 

Compiled scripts are alwjiy*s stored with the fixed ID 128. 
This allows us lo use the ODF restjurce sulisystem to Irrad Uk* 
resource instead of reveniag to the Mac08 tooltox* This is 
done by simply creating a instance of the FW_CResource 
class* Tilts class loads the resource in iLs constructor* and 
releases the resource in its destructor* It is exception-safe, and 
works correctly on lx>th Macintosh and Windows* All we need 
to do fo finksh internalizing the sc:ript is to copy the resource 
iiandJc and stoa^ it iaside die fScriptHandle data memlx^r. 

llie CSoundAction: :DoIt method executes the scrip! lusing 
the static rnefhfxl CSc r iptAction: iLoadAndExecuteScript: 


(-StTiptAaiun::DoIt 

void CScriptActioni;DoItt) 

I 

if (fScriptllandle != HULL) 

LoadAndExecuteScrlpt (fScrlptliaFidlt); 

) 


(>k:riptAak)n: LLustdAnilExtcuttik.Tipt 

VO I d eSc r 1 pt Ac t i on:; LoadAndExeciiteSc ript {Handle sc riptData J 

t 

AEDesc scriptOesc* 

OSAID scriptlD. resultlD: 

AEDesc scriptTextr 
OSAError error: 

static CompofientInstance gComponetit “ 0: 
ir (IgCoBipuncnt) 

gCoMpotienl - : jOponDefan) tCompnnenr ( 
kOSAComponen tType * 

kOSAGenericScriptingCoinponentSubtype); 

// kMid tho script data 

Br.riptDesc*descriptorType typeOSAGonericStorage; 
ficriptCesc-datsHandle = acrlptData: 
error ^ : tOSALoadigCoitponent. iRcriptDesc, 
kOSAModcNulK iscriptTI»: 

if (error = noErt) 

i 

// cxtcuic tbe cotnpUed saipi in the default conic at 
e r to r = r:OSAExecute{gCoap onen t * 

scriptTD* kOSANullScript, 
kOSAWodcNull* ArfiBultlD): 
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i Act: ion: 


error = : :OSADispose(gCojnponent. scriptlD): 
errors : :OSADispose(gCoiiiponent, resultID); 


The re not much to about this code. 

LoadAndEKcecuteScript b lifted almost verbatim from 
miAC, pp, 10-16. 1 haven’t Ixithered to address the tact that it 
just leLs errors fall on the floor unnoticed, though with the post- 
L0d9 additions to exception liandling it will be a relatively easy 
task. All that is necessary is to sprinkle a few calls to 
FW_FailOnError(error). 

Tliat basically completes the description of the aaion clas.ses. 
Observant readers will note tliat I’ve not yet described tlie two 
static methods IsInStorage, one each for the classes 
CSoundAction and CScriptAction. Well get to that shortly. 
Let's move on to the iniplemeritation of the class CBeeperPart. 

ClieeperPart 

Earlier^ we saw a partial class definition for 
CBeeperPart. At that time^ we were interested in the 
protocol inherited from FW_CPart; we were c^nly concerned 
witli the protocol related to Aclions. Now that we’re ready to 
talk about the part [irotocob it might l>e worthwhile to see a 
mnplete definition for the class CBeeperPart: 

class FW^CLASS^TTK CBeeperPart : public FW^CPart 
I 

public: 

static const ODValuoTypo kPartKind: 

//‘ - 

ft InittalizatiotVDcsiruciioii 
// 

public■ 

CBeeperPart(OEPart* odPart)j 
virtual '^CBeeperPart (): 

virtual void Initialize[Environnient* ev): 


//- 

// InhtTittdAPl 
// 

public: 

vjrttm l FW_CFraP5C’* MowFraine [Envirotimcni * ev , 
OlH’rami"* odFrante, 

!■ W_CP r e s ei] I a 11 a n * p r e sen t a. 11 citu 
i'W_3oolean fromStorageJ ; 

virtual void IntornalizeCoritent(Environment* ev, 
ODStorageUnlt* storage, 

FW CCloneTnfo* cloneTnfo); 

virtual void ExlornnllzeContenL (Euvlmninerit * ev, 
ODStorageUnit* storage. 

FW_CCioneInfo* cloneTnfo): 


//-- 

// New API 
ft 

publie: 

CAciion'' GetActlonC) I return f Act ion; 1 
void SetAction(CAction* action): 


public: 

void DoActionf); 


//—- 

// Uam Mcnibt"ni 
// 

pitvate: 


CAction* 

1 : 


Lee’s begin with the constructor and destructor of CBeeperPart: 


CBeeperPartJleeperPart 

CBeeperPartCBeeperPart(ODPatt* ndPart) : 

FW_CPart(odPart, CBeeperPa rt: :kPartKitid), 
fAciion(NULL) 

f 

1 


CBeeperPart::-CBeeperPart() 
\ 

delete fAction; 


CBeeperPart;: tkeperPart 


The consmiaor initiali7.e,s the FW_CPart base and 
initializes the fAction field to NULL. The destructor simply 
deletes the object pointed to by f Action, Of course, the 
FW_CPart constructor does quite a bit of work; CBeeperPart 
inheriLs a lot of default l:)ehavic)r from iLs FW_CPart Irase class. It 
Ls lieyond the scope of this article to go into the details of tlie class 
FW_CPart, but suffice it to say that ODF imkes it pretty easy to 
c:reate a new part by overruling just a few methexLs, as we'ie about 
to see. Tlie next method is the Initialize nietliod: 


CBeeperPart;: 1 nitiilize 

void CBeeporParLInitialize(Enviionroeni’ ev) 

I 

FW_CPart::Initialize(ev): 


] 


// ““ Re^Lster our Presentatiofi 
CBfiepnrSolect.inn ’nelRctJoq " 

new CBeoperSeleetlon(GV» this): 
RegisttjrPrystjnLaiiontev, kODL'BeepurPrvsentation, 
TRUE, selection); 


To initialize the CBenparPart, we must first call the 
inherited metliod to initialize the base class. Next, we create an 
instance of CBee per Select ion, which is a subclass of 
FW_CSelect ion. Selection objects are used to designate the 
u.ser’s selection for data interchange via any of the interchange 
mechanisms: copy/paste, drag/drop, or linking. Finally, we 
register a preseniation. Parts may have multiple presentations for 
displaying tlieir data content. A cla.ssic example is a spreadsheet 
application that can display its data in a tabular array, bar chart, 
pie chart, etc. Each presentation may have its own selection, so 
the selection object is owned by tlie pre.senuiiion. 


CTBccpcrnj It: :Nc wF ramr 

FW_CFratne‘ CB^eptfrPart: :Wewl'ram&{EnvironEent* ev* 

ODFrarae* frame» 

FW_CPres entation* presentatlon. 

FW_Boolean stotage) 
t 

return new CEeeperFrarie (bv , frame, presentation, thi.s): 


NewFrame is a factory method which will be called 
whenever ihe pan needs a new display frame. If a part 
supporLs multiple presentations it would create different kinds 
of frames, but our Beeper part supports only one simple 
presentation and creates only one kind of frame. 
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CBeept'rPart: ntemalizeCVmte nt 

void CBeeperPart: :lnts?rnallze€ontent(Etiviromiieiit *ev. 
ODStoraaeUnlt* storage» 

FW_CCloneInfo* cloneinfo) 

I 

FW ASSERT{fAction -- NULL): 

if (CScr i ptAct i on: : ToTnStoragf? (gv . storage}) 
fActlon “ new CScrlpLAction{); 

else if (CSoundAotlon:rlslnStorageCev, storage)) 
fAction = new CSoiiadActionT} ; 

if (fAction !“ NULL) 

fActlon->InteTnallsG(Gv. storage): 

I 


dictionary mapping known data interchange types to factory 
functions. However, for the purpose of this example, such an 
approach is clearly overkill. 

Once an action instance is created, we initialize it from the 
storage unit using the internalize vimial function. 


ClkeptrPan:: ExicmaliiteCon leni 

void CBeeperPart: lExt^rnfllizeContent (Envlrornn&rit ‘ev. 
ODStorageUnit* storage, 

FW„CC1 oneInfo* cloneInfo) 

1 

// If any kind of property^ content exists... 

if (storage->Exiatstev. kODPropContents, kODNULL* 0)) 

I 

storage->Focus(ev» kOBPropContentE, 

kODPoflUndefined. kODNULL. 0. kODPosAll): 
storage >Rei30ve{cv); 

] 

storage->AddProperty(ev. kODPropContents); 
if (fAction != NULL) 

fAction'>Extarnalize(ev, storage): 


External!zeContent checks to see if any previous 
content cxisLs in the sLorage unit, and if so, removes tite old data. 
It then adds a content property, and delegate.^ the task of 
externalizing to the Action object. This will result in a call to one 
of the two methods CSoundAct ion : ;Externalize or 
CSoundAction :; Internalize, whkli we have already seen. 

CBer pcil'irt:: DoAction 

void CBeeperPart: iDoActionO 
I 

if (fAction !- NULL) 
fAction->DoIt0: 
f 

DoAction is cxecuicd whenever ilie button is pressed via a 
mechanism that well di.scuss shortly. DcActioii merely 
forwards the request to the current action ohject. 

ClkeperPart:: SetAciion 

void CBeeperPartSetActicin(CAction *actictn) 

t 

ir (action actiDn!=fAc:tion) 
f 

delete fActien: 
f Act ion = tic tion: 

1 

1 


IntcrnalizeContent is called when the part is being 
initialized frc)m storage. CBeeperPart determines wheiher 
the storage contains a script or a stnind, creates the 
appropriate action olijecL, and then dcTegaics to the action 
object. Here we finally see the purpose of the two static 
methods CScriptAction::TsTnStorage and 
CSoundAction: : IsInStorage. Tltese methods examine 
the storage unit to see if they contain the appropriate data type. 

This mechanism for creating an instance of the right action 
type based upon the contents of the storage unit is a hit 
simplistic. If we had many action kinds, it would become 
awkward, and a more extensible mechanism would become 
desirable. One reasonable choice would be based upon a 


SetAction is usetl to change the action objed. It is allied when 
a client of CBeeperPart wants to change the part’s current 
action. Well see it used by ilic GBeeperSelection class. 

CBecperFramc 

ODE contains a clasps FW_CFrame which provides a rich 
definition of die l>ehavior of OpenDtx^ frames, EW_CFrame 
inherits behavior from lour mixin classes CFW_MEventHand let, 
FW_MGadgetContair3er, FW_MDragDroppable, and 
FW_MIdle), and has alx>ut 1(X) metliods! Despite tlie size and 
apparent complexity of FW_CFrame, implementing a subclass is 
relatively easy; CBeeperFrame overrides only five metliods: 
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CBeeperPart * fBeeperTari; 

FW_CFushButtoii* fBeepet I 
ODID fButtonli; 

FW CHandleFunctionConnection fConnection: 
ODTy peToken fEuttoJiMot i f i caci onToken; 

I: 


CBeeperFrame indudes a buiion gjidgci, so ti overrides tlic 
mcThod CreateGadgetLayout to create the button gadget 
CBeeperFrame can accept a drop of either scripts or sounds, 
so it overrides CanAcceptDrop, li overrides Draw to render 
irself, and it overrides the FrameShapeChanged notification 
to update its layout when the frame is resized. Finally, it 
overrides die HandleNoLificatlon metliod from the mixin 
class FW_MReceiver .so dial it can respond Lo huLUm presses. 
Let's now look at die implenienlation of these methods. 


rFl«:pt rFran^e:: CBeeperFratnc 

CBeeperFranie:: CBeeperFraitte (Envi t onmen 1 * cv, 

OOFrame* frame. 

FW_CPresentatlon* p resantation. 

CBeeperPart' part) : 

FW CFramefev, frame, presentation, part)* 
rPa rt (pa rt), 
rReopor(Ma.) * 
fButtonid(0), 
fConnectionCthis), 
fButtonNotif icationToken(t)) 

I 

f Connect ion. Connect (): 

ihl !!-)AddToFociiF!Set (ev . part - >GetCl IpboardPocusToken (ev)): 

Sn t llroppablctov, TRtlF); 


class Fy CLASS ATTR CBeeperFrame ; public FW_CFraaie. 

public FW Hleceiv&r 

t 

fh - .---- —- 

// ItHliali^iliufu/Dc^inictian 
// 

public: 

CBeeperFrame{Enviromnent* ov. ODFraiiie* frame, 

FW ePresentation* preaentatioti, CBeeperPart* part): 

virriml -^nBeeperFraitieO : 


ff l‘■W_(:KrJmc livtTfidcs 

// 

public: 

virtual void CreateGadgetLayout CEnvironment * ev* 

FW CGadgetlnitializer^i initiali^e^): 

virtual ODbragRcuul l CanAcceptnrop{F,tiivt rnnmont * ev* 
(JlH)ragUeral tetiUor ’ dragTnfo); 

virtual void Draw(Environment* ev, 

ODFacet* facet, ODShape* InvalidShape): 

virtual void FrameShapeChanged(EiivirDiiaent* ev): 


U FW^MRccdvcr overrides 
// 

public: 

virtual void KandleNotlficationC 

c.onflt FW CNotificationi notif icatiori): 


-- 

// Data Members 

// 

private: 


The constnicLor initmlizcs the base class and data niemlx^rs, 
and then sets up the nod heal ion connection, prepares to 
receive dam from the elipboarth and registers iLself as being 
interested in receiving data through drag-and-drop. 

.. (.Ik^prrFcamt'MlVcpcrFramc 

C B(fc pe r F rumt*:: -CBeo po r F r o me t) 

I 

fW_Cinierest interest (f Beeper. fButtonNotlEicationToken): 
fConnection. Removeinterest (Interest): 

I 


The destructor removes the notification connection. 


(: Hcfricri-ramu::(IreatcC i:idRctLay out 

void CBceperFrunic: :CrcaLcGadgoi jiUyoui [Rnvi roimcnt* ev. 

FW^CC ad ge 11 ril t la 11 iie r & 1 ii 11 i a ] 1 kc r) 


I 


FW.CDynamicString label ("Beep’'] : 


FW CRect fratncRert: 

th}n->CcTFrnnieShapeBAundfi{ev, f rnniRRflrt): 


fBeeper “ h'W_HEW(FW^CFusbButton* 

(ev, initialiser, this, fButtonid, 

frameRect[FW_kTopLeftj, frameRectlFW„kBctRight], 

label)]: 

fleeperOSetDefaultfev* fal&e); 


FBut LonNol i rical ioiiTokcn ^ 

fBeeper >GeLBut LofiPressedNotiriciit loiiTokcri (ov): 
FU_Clntereet interest[fBeeper, fButtonNotificationToken); 
fConnection.AddInte test(interest): 
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G reat eGad getLay Dut creates a button of type 
FW CPushButton, and then establishes its interest in 
receiving notifications for button clicks. Tfje noUfication 
suhsystcfn is a generai-purpose mechanisni for establishing 
event dependencies lietween objects. Qbjeeis may serve as 
Notifiers and Receivers. In our case, the pu.sh-hutttm is a 
notifier, and ihe frame is the receiver. Tlie FW_CIntcrest 
obiect estabiishes an interest in a particular kind of notifiaitian, 
in this case button pressed notifications. Ai^iding the interest to 
the connection object esiahlishes the connection. Once we 
establish tijc connection, l>uUon presses wiil result in the 
receiver’s I lancIleNoiification methcKl (see beiow) being called. 

OktpcrFrjme; :CmALCt:tHJ>n)p 

OBDr^irgRef^dlt CB&eperFramft: :CanAcceptDropCEnvironment* ev. 
OnOra^Ttcmlrt^rfiTor’ dragTtifo) 

DDDr&gRemlt acceptDrop = 

FW_CF rame r * Ca nAc ce p t D r op (ev, d rag i n I d ) ■ 

if (!acceptorOp) 

I 

for ConSTor^geltTilT •rfragSlt = dragrnfo->First (ev): 
drngSa I- NIJT.T.; 
dtagSU ” draglnTn >Kexi tev)) 

if teSoundAction::IsInStoragetev. dteigSU)) 
return TRUE: 

if [CScriptAction::IslnStorage(ev, dragSU]) 


return TRUE; 

I 

1 

cetuiii accopUltop; 


CanAcceptDrop iterates over the storage units of the OpenlX>c 
drag item, looking for one that contaias recogniziible cbta. If it 
finds either a soimci or a strript, CanAcceptDrop returns true. 


void CBeeperPrame: :Dratf(Environicenc* ev, 
ODFacet* facet, 

ODShape* invalidShape) 

( 


Clk-q>ff Fni me)raw 


FW^CFanetContext fr(ev. facet. invalidShape); 


//Just erase and assume gadgets will draw 
FW_CRect invalidRect: 
fe.GetClipReei (itivaiidSect): 

FV CRectShape:iRenderRect(fc. invalidRect. 

FV kFill, FW.kWviteEraselnk); 


Tile tmly rendering dmt a CBeoperFrame needs to explicitly 
do is to erase; tlie PushButton gadget will dra w itself. 

QkqKTl'ranie:i landlcNmlT^^ 

void CRocporFrawin: ;BandlflNotific;ation( 

const FW_CNoiIficationA notification) 

I 
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UrSBlBSbll. makes your installer choice easy 


Easy for your users 

Draglnstall's ujnique drag-and-drop interface makes inslalling your 
software a piece of cake for your users. And cuts down on tcch support calls. 

Easy for you 

Draglnstall's Builder utility allows you to create complex mstallers in minutes 
not days. And without the need to learn a complicated scripting language. 

Easy on your wallet 

Draglnstall's one-time fee of only $300.00 allows you to distribute an unlimited 
number of installers. No yearly renewals, no royalties, no hassle! 


To find out just how easy 
Draglnstall is, call us at 
1^00-890-9880 
to receive a free demo disk. 
Or contact us at: 

Ray Sauers Associates, Inc. 

1187 Main Avenue» Suite 10 
Clifton, NJ 070112252 USA 
Voice: 201478-1970 
Fax: 201^78-1513 
E-mail: draginstall<g>sauers,com 
ww. sauers.c om/drag instal I 


const Py CButtQnPrfiSfiedMotificatlonfc buttonPressed - 
(FW CButtonPfRRRedNoTification^) notificalion: 

if (bnttonpressed .GotBulloiildO = fButtonld) 

I 

ffleeperPaTt->DoAction(): 

1 

I 

HiLs mcrhixl is inherited from FW_MRecelver, and is called 
by the notification subsystem. This method first checks to 
ensure that it is receiving notification from the correct Inmon, 
and then forwards the action request to the part (which will 
forward llie retjuesl to the current CAction object). 

Ulccpcri'nnK::haiiicShapc^^ 

void CBtfi^perl-raaie: rFrameShapsChanged(Environment^ ev) 
i 

FH_CFraiie: :FraiieShapeCbanged(ev): 

// Resi/jc the Bet^per to fit the ntrw fiuinc size 
FV CRect fraiiHRect: 

thifi ->Gftt:Frara<^Shapf?Rounds(f?v. fraaieKect) t 
ffipopor >SoiSijse(ev, IraineRect,QotRight {) h 

// Redraw ihc cmirc thiint.' 
this->Invalldate(ev); 

1 

When ihe fmme shape: changes, the frame .simply resides the 
push-button to lake up tlie entire frame. 

CBc*e|H* rSe Jec lion 

Tlie ODF class FW„CS el action is an abstract base class 
used by ODF lo represent die usctIs active scleclion of data. A 
Copy command will copy this data to the clipboard, drag 
operations copy or move the selected data, etc. 
FW_CS elect ion defines four pure virtual methods that must 
be overridden; FW_CBeeperSelection defines these and 
overrides two more. As it turns out, the tselection'' of a Beeper 


part is always the entire data content, so tlie implementation of 
these methtxLs Ls especially simple; most don’t do anything. 

cliiss KW^CLASS^Am CBeeperPart: 

class FW_CLASS_ATTR CBeeperSelectlon : public FW CSfilacticn 
i 

// tnltulizarifni/Dcsmiction 
// 

public: 

CBeeperSeiectaoa (Envi rontaent * cv. 

CBeeperPart" beeperPart): 
virtual -^BeeperSelcctionO; 

// Inberiicd API 
7/ 

public: 

virtual void ClosaSelectiontEnvironinunt* svJ: 
virtual FW_Boolean ClearSelactiontEnvlrotiioeut* av. 

Fy_ Clear Selection cl*?arAfl pr); 
virtual FW Boolean TfiEinptytEnv i * rvi cmisii 

virtual void SelectAn (Euvtnnuunont * ov): 

virtual void DoExietnallzoS^^lcciiondinvironnient* ev. 
ODStorageUnit* storage, 

FW_CCloneInfo’ clonelnfoJ: 

virtual FW_BooLean DoInternaliKeSalactiDniEnvjroniupnt* ev, 
ODStoragfilJnit* storage. 

FW_CC1 ortfl T n f o • r 1 oneT n fo): 

// Data Mumbcfs 
// 

private: 

CBeeperParf fBeeperPart; 

J: 


€Btnrpci$dmion::a»c^^ 

CBeepurSeiection: :CBeeper Select ion (Environnent* ev, 
CBeeperPart* beeperPart) : 
FW_CSeiectioii(ev. FALSE. FALSE), 
fBeepsrPart(beeperPart) 

\ 

I 
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Guide Composer 

Previewed at WWDC ‘95 


Develop Apple Guide files for any 
new or existing application 

Available from the MacTech Mail Order Store 


• No Prof^amming 

• WYSIWYG Content Entry 

• Coach Marks 

• Index Terms 

• PICTs 

• Sounds 

• integrated with Guide Maker Lite 
(included) For Easy Compiles 

• Optional Source Code Output 

• Change back from your $100 


Demo Available: 
AppleLink. AOL. CIS> 
eWorld, ImcmctJnfo-Mac 


Mac'OS 


$99 


Ctmitwo' h iirBlciiNirk of Slept Jp SkilVwiitc Twde n w Apptr i'tuMfwtrf. I(K 


STEP"'* 

SOFTWARE 


7110 Glendora Avenue 
Dallas, Texas 75230 
214-360-9301 
214-360-0127 fax 


TJic CBeeperSfilect ton mnstaictor .simply imtializes its base 
classes and caches away a puinicr to the part. 

CBccpeiSclcction:; - t^lkrcpcrSek'tt ion 

CBeeporSelectiyii: :"CBei?perijeleetion(J 

I 

1 

Thu dcsiruaor d<)usn't nuud in do anything. 

(JfccpcrSelcct ion: :rii wcSclect ii in 

void CBeeperSeiection::CloseSeIectionCEnvironnieni* ev) 

I 

1 

In our case, closing a selectiori is a no-op... 


Tlic Ikeper’s data is always selected, so there's nothing to do. 


ClkcpcrSck'CLitm::l>(>Extt:rnalizcSclcaioa 

void CBeeperSeXection: :DoExtornall2eSelec:tlon( 

Environment’ ev. 

ODStoragnUnit' storage, 

FW_CCloneTrifo* clonelDfo) 

1 

CAcrtion 'acLltJii ^ iBeeperFart >UetAction(); 
if (actioiij 
[ 

storage ->AddPtciperty (ov, kOBPropContents): 
action*>Extetnal!ze{pv, storagej; 

I 

I 


DoExterrializeSelection isn't a no-o[5, [>ul it is slill trivial; 
We merely forward the openition onto the action object. 


rBccperSrlrcl ion: :C irirStdccl ion 


CBcTpctSdcak}ft:DDlntciiialbEcSckction 


FW_Sooieaii CBeeperSelection: :ClearSelecT lon(Envl rotiment' t*v« 
PW CiearSelection clearAficr) 


I 


return FALSE; //Do nothing 
I 


...as is clearing the .selection. 


(IBccpcrScImion:: lsF.ni pi y 

FW^Botilean CBeeperSelection: jI^Empty £Envl roniieni • cv) const 
I 

return (fBe(>perPnrt->GerActiun() = NULL); 

I 


A CBenperSelection is empty' if it does not have an aclkm. 

CBceperSckction: iScIcet All 


FW_IJooiean CBeeperSelection; iBoInternflll xeSfllpcti ont 
Environment* ev* 

ODStorsgeUnit* atornge. 
FW_GClonerfift>' cloneinfo) 

i 

FW_iiooleaii internalized ^ FALSE; 

CAction ^action = NULL; 

If teScriptAction;:IsTnStorageCev. Btorngo)) 
action ^ new CScriptAcrion(); 
elfie If (CKoundAcr I on :: Tsf nStOfage (*?v. storage)) 
action * new CSoundActionO; 

If (action i= NULL) 

i 

action“>Internalizetev* storage); 
fBaeperPart-)SetAction(action): 
fBeaperPa rt ^Changed[ev); 
internalized ^ true; 


void CBeeperSelection;;SelectAll{Environrafint* ev) return internalized; 

i 1 

J 

DoInternalizeSelection is sligliLly more complicated It 
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siloulci lcK)k fjimihiir, alncc iherc Ls not modi dMerence tx^iween 
ihLs rneiiiod and the CBeeperParL: : InternalizeContGnt 
inciiitKl, We .simply determine lype of data to Internalize, create 
the appropriate action ohject, initialize it with the data, and then 
ask the part to make it be the enrreni action object. 

WllAl HAVE WE DONE? 

You've now seen all tlje custom code needed to create our 
enhanced Bee[KT part. It Ls not really a Cfvnipleie part yet; it is 
missing some obvious features that a truly useful Beeper should 
have, not the least of which is a lx.*tter name! 

One key feature that the Beeper needs is the ability to 
change the title of the button. If you look hack over the code, 
yf)u'll see that the button title is tiaal-coded to lie Beep inside 
the metluHl CBeeperFrame: : CreateGadp,etLayotit. A 
real fiart would allow the default title to lx* spc'cificd from a 
resource, and provide some simple mc^ans of ciianging the title. 
One possibility is [o allow dropping a text clipping as the 
means of setting the title. Another possibility is to set the 
liunon title to the name of the file dropfx^d onto the button. 
No doulit you can think of other features tkit a burton-as^part 
should have, such as a visual style more interesting tlian the 
simple rt>u nded-rectangle. 

If you look past these shortcomings, 1 lielieve it's fair to say 
that fliis example is a t>rctty impre.ssive demonstration of the 
(KJwcT of Open Doc and Oi>F. Witli tmly a siimll amount of 
codc% we have created a tmly remahle .styflware component. 
I’m not talking alxjut the code-level reuse that we were able to 
acliieve l>y using ODF, which is no small inaiier. Piu iasiead 
talking of the much more dr:imaiit: reuse aclueved by high-level 
componentization. Tire ODFBeeper part Ls a component that 
ran lie reused without needing a single adilitional line of C++ 
code, hnd users with just a modest understanding of 
AppleScript could use the ODFBeeper component to create 
applications customized to their needs. 

Clearly, the ODFBeeper component by itself, or even 
ccmibined with a container pan like ODFDraw, would not 
significantly empower end-users. We need quite a few more 
c:omiKments before well see such a dramatic shift. However, 
considering how easy it was to CTcate this component, it 
doesn't take much imaginaiitjn to believe that we could s<.x)n 
have a wide assortment of [powerful components. 

WlL\PPL\G lip 

With that uplifting vision of the fiitore, ifs time for me to tie a 
bow artrund this article and ship it. One of my goals for tliis 
article was to give yon a taste of what it’s like to develop for 
Open Doc with ODF. Hopefully ids left you thirsting k)r more. 
If you’d like more information about OOF, send a note to 
odfS6ed@dpple.com; or feel free to write to me. 
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By Neil Ticktin, Editor-in-CMeJ7Publisher 



Dylan Livrs 

Jim Cagoon [Dial^>g Bax, St^ptcmberl may have many reaiions 
for not using Dylan. Htjwcvcr, “...unreasonable to ... expect 
sut:eess from a proprietaiy language...'’ shoukln’i be one of 
them. [The Fact that it Isn’t out yet in ready-for-prirne-time form 
is a reason.) 

'Ibe language spec Is in llie public domain. 'I'he keepers 
aa^ at CMI J...talce a look at 

http y/Iegend .gwydion. cs.cmu .ed u:8001 /dylerV 

The nanie Dylan remains with Apple for the purpose of 
controlling its usage to conforming implementations (aging 
entertainers who themselves appropriated the name 
notwithstanding). Apple may someday have a Dylan 
implcmenlalion available for Mac developers. Meanwhile 
Dylan-like things are “all over" on other platforms (and 
Macintosh). Ihey aren't called Dylan because they aren't yet 
(as in “Mindy''...Mintjy Is Not Dylan Yet). 

- JohJi W. Baxter, Pori Ludlow, WA 


CGIs IN C — Some Tweaks 

Just a few notes on tlie anieJe "Writing CGI Applications in C7 in 
the Septemlxrr, 1995 issue of Macl ech. 

POST arguments can be up to 32k in size (not 24 as 
iiulicated on pg. 36)* i he u.semame and password are benh 
limited to 32 bytes. 

You state on pg, 41 that "you c:an not aUocate or release 
memtjry within a thread context/ Tliis (mly applies to pre¬ 
emptive threads, which were only implemented in the (iHK 
Thread Manager CtH>tKraiive threads can do what the main 
aj’jplit^ation thread am do. 

t haven't Icxiked at the responder code recently^ l>ur it used 
to be missing the call to MaxApplZoneO during startup. Thai 
becomes quite necessary if the application is going to be 
dealing wiih large chunks t}f data. 

Thanks for writing the article - I got some useful ideas 
from raiding it! 

- GratU Netifeld 

According to John OTallun, the }K}int almtii using memory 
within a thread context is inie, hut remeher ihai a call Lo 
MaxApplZone is recfuired l)efore threads aikKate memory. 
MacTech, November 1994, P. 68 for more detaiLs. 'there are 
ma ny ihings that Respo nder doesnl do^ ma t nly hecause 
Resfxjrider is a simpH/ied application to teach CGLprcjgrammifig. 
- Pd. mt 


What Ever Hafpi-ned to FORTRAN? 

First, let me laud your publishing of articles on Prograph CPX. 
This certainly is the way of the future ttf prt)gramming on the 
Mac. Indeed it is a natural extension of the Mac’s iconic 
interface. I'm also delighted to find that thea* are two books in 
the offing concerning the programming of CPX. My background 
lias lx:en in rhe procedural languages, and \ need some extra 
lielp in making the culture change to OOP. 

Second, let me moan. In the past Mac'Futor and then 
MacTeth gave coverage to the language 1 u.se most of the time - 
FOKTRAN (LS FORTRAN), But the past year or st> luus seen a 
withering and tfien ti>ial al>senc:e of coverage of this language - 
first Joig's Folder, tlten Jorg, then FORTHANs from the Mail Order. 
I know it isn't the most modern language, but there is a 
considCTal>le opus of large scientific/engineering ccxies wrilten in 
FOIfl'KAN which have !xx*n debugged over dei'ades. Those who 
use these ctxles are first of ail rather inlimickted by the ide^ of 
converting I hem to other more modem languages due la their 
size and second do not relish the large amount of time it will take 
to make the new code.s as reliable as the existing FOR'FRAN 
codes. So, i don't think tliat FORTRAN Ls dead by any means and 
it is disap|X>inting not to have Jorg's Folder any more, especially 
with the evolution t>f die Power Mac' versions of FOH'IRAN. 

- Stt4 Qxjk Mi Hilaire, Quebec 

iSlu: Our biggest reason for not mnning FORTRAN articles is that 
tife Te not seen anything worthy of printing. While FORTRAN 
afiicies shouldn V get the same mlume of coverage that C++ or 
eiKm Pascal should (since there are more users of those 
kmguagesK it does deserve coverage. We're t^nrn to puhlishtng 
FORTRAN articles - anyone interested in tmttng oneF - M nst! 

Bu i, You Mis.sf.i> The Poini 

I'hank you for your comments at the end of my letter 
c'otnplaining alxjut SyuianicT's C++ 8.0, but I think you missed 
the point of my last comment. 

If it would be so hard to write u PowerPC versiim of 
THINK Pascal, then liow^ about a compiler that will accept 
THINK Pascal source ctxle and produce native PowerPC object 
code. We progr^immer.s could do our program development 
using the present THINK Pasctil development enviroomcni in 
the 680x0 emulator. 

The THINK Pascal 4.0,2 compiler in the emulator Is so 
much fiLster than any native C or C++ compiler that there is no 
real speed penalty for using the present compiler. After we have 
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a working 680x0 program, wc can feed the sf)urce code to the 
Powerrc compiler to pnxluce ifie final axle. 

Since we will only lx.* u.sing this compiler a few times per 
program development cycle, il can be a slow dog like the 
Symantec C and C++ compilers. It doesn't have to have an 
editor and debugger like a real development environment. Ir 
just has to relialily compile previcnjsly pn>ven ccxle that was 
developed using the present excellent THINK Pascal 
development environmenU 

” h'miJohmon, Knoxvitie, illinnis 

/Fred, yourpmyen haw (or udii} ansu^ed .shortly. Will lu^on 
m Symantec reiLs us that Symantec has canu* to an agrameru uith 
fMnguage Systems O^rp. LS uiU jn-oLide an Object Pascal comfnler 
that will drop into the Symantec Project Managitr immrxmment 
that should cotnpile TlilNK Pascal 4.0.2 source code For more 
information, contact Language Systems can he reached at 
htif)://wuw.langsys.com/langsys or 800-252-6479. 

!n addition, there is a version of the Universal Headers 
modijied to mirk nnth THINK Pascal that Symantec will make 
availahle hy the end of Oemher, 1995^ These files will he 
available on the next SDA CD ami prohahty online. Check the 
MacTech ux47 sUe (hitp://tm(m\mackKh.€om/s^MxmL^^ or the 
Symanlc*c site for more mfomuitkm - Ed, nsti 

iMany thanks Ur. 

Daniel Lidoff, Atascadero, CaliftJrnia 
/I'enorll^aolxoni 
S.A. Klein, Madison, Wisc'onsin 
Anthony Pa nos 
human Wing 

Chris F. Riley, Miami, Florida 

who also expressed similar opinions al/out wanting to bring 
THINK Pascal to Pouw Macintmh. - Fd. nstl 


Brain Damaged Languages? 

Fred Johnson hit the nail on tlic head with his Iciier, printed in 
the Dialog Box section of the March is.sue of MacTech. He 
pi-aised the editor and linker of THINK Pascal, as compared to 
iluxse of Symantec C++. But he did not go far enough Ito fully 
ex[x>se the language's Ix-liind the environments!. 

I, like Johnson, am somewhat of a Mac hacken 1 have 
programmed tlie Mac profes.sionully, but I consider my.self to 
l>e an engineer who programs rather than a programmer, I 
have prograTnmed using THINK Pascal, THINK C, and 
Microsoft QuickBASIC, 

The BEST feaiure about THINK Pascal is its debugger, 
LightsBug. It i.s supcrt> and clearly lx?tter ifian anydiing else 1 
have used. (Why hasn’t Symanfet' made tlie C/C++ debugger 
more like LightsBug?) 1 can examine all global and local 
variables immediately, wiilioui having to first .select them for 
display as in the TOINK C debugger. I can see the chain of 


calling routines, examine register variables, kxjk through the 
heap, iTKxJify variables, and set watch points. Andl can also 
examine and set memory dircxtly. 

J also share Johnson's opinion of C and C++ (or rather, 
Symantec's X with objeas”, which is as close as 1 have gotten to 
C++.) Both are a mess* Ft>r example, what kind of brain-dead 
language knows the lyjx* of a variable in a “prinlfO" function 
call, yet makes liie programmer specify il again with a formatting 
contitjl ctxle? I end up rlehugging tny "‘printfO” function calls. 
(And chat Is just one example. I could go on and on.) 

I made two serious efforts to learn "C with objects” but 
gave up in frustration both times. OI)|ca Pascal was a breeze 
afiLT wrestling with C. (Even the manuals be;ir ihis out: the 
"Object Pascal'' chapter is 14 pages for version 4 of Pasail; 
the ’^Using Objects in 'I’hink C" chapter i.s 37 pages for 
version 5 of CJ 

The Object Pascal implementation of oijject-oriented 
programming is simple and elegant* With the use of just 3 
additional keywords ("ohject", ‘^inherited", and “override*’) and 
one function (“membuK)”), 1 am prognim in an OOP language* 
Although 1 can't speak from experience with C++, if my 
experient:e wiili “C with objects" Is any indication, C++ is a me-ss. 

Tlie world seems to have run after C, but after using both, 
I don't know' why* C is Ix^sl descTihtxl as a cryptic high-level 
assembler. Pascal is a well-designed high-level language* 
C'mon Symantec, support Pascal. 

- Sieve Ros*;, stetc*_ross^mtp.stflJruKCom 


Criticism of Fr(k;kamming Sttle 
1 just received the winning solution to the programmers 
problem. It use*s several goto statements and is not object 
oriented. As the only prt>gramming journal for the Mac it would 
be nice if you'd adopt a more “progressive" approach to 
teaching piogramming. Old notions of “efficiency" are [)as>se* 

-Don Winston 


Chasing Down Semper.Fi 


Due to listservcT changes, the instrucitons to 
subscrilx,* to the Semper.Fi mailing list in the Seplcrnbcr 
Viewpoint were obsolete stxm after we went to pre.ss. 
Here are updated instructif)ns: email to 
lisiprtx:#abs*apple*corri a message with this command in 
the body: "subscribe semper.fi <your name here>“, 

If you want to see what other lists are available from 
tfiis listserver, send the "list" command, or see the web 
page htip://abs.apple.com/applc-intcmet/. 
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UNIFORM 

RESOURCE 

LOCATORS 


liyJim Straits, URLs@maclecb.com 


S])arc your fingers ;md find this column online at: 
http://www. mactech .cam/U R Ls.htmf 

Also, for a liniilud tiinc, yon can send mail to: 
URLs@cJass.com and you'll receive the latest list hack* 


MacTach' 


Lntemel Ratted 
List of Mac Mailing-Lists 

New Ta:hnologies 
open Transport and PCI 


Latilsi Updates 

hiip://vww*macf^. com/mailing] isis. Ntm [ 

hiip:y/piloinjin.nei/-msprDul/ 


Other Programmer Resources 

Forir an to C converter ftp://alum nt, caltech. edu/pub/M ac,F 2 Q 

Grant's CGI framework in C http;//arpp 1 .carleton.ca/grant/mac/graritscgi^ 

MacHadc_ http:/Av^.machack.com/ 

Parse CGt OSAX http://marquis.lia(Lnet/softwafe/home.html 

Prefab Software bttp://www.tiac.nel/prefab/ 

Vendors, Products and Miscellaneous 


Absoft 
MacHax Group 
Celestin 


LPA Prolog 

MacMagazine 

MacNei Journal 

MaeWeek 

The Ultimate Mac 

Vlf>J 


http;//www. absofl .com/ 
http://www^hax.com/hax. html 
http://WWW .celesli n .com/ 
http://www.lpa*co.uk/ 

hnp://oeon li nexomiBO/~ tomk/MacMagaiine/ 
http ://www.dgf. com/web_n i r ij/ 
http ://www.zdnet.co m /-m aeweek/ 
http://Vvww.freepress.com/myee/ultEmate_mac.htmJ 
hi tp://efeh won.c altech.edu/vidiAidi-homepage. html 


Internet 

Mailing lists are tme of the more popular ways of distrilHitiiig 
information on the InteineL 1'hey can macii a wider audience 
than news groups or the worid wide web, lx‘ moic* selective in 
their distribution, and reach their tc^aders in a more timely fashion, 
'ITie Well Connected Mac has a list of over 150 Macintosh specific 
mailing lists that cover a latge range of topics. You can sui>s< ril>t* 
to as many as your patience and maillxjx will allow. 

List of Macintosh Mailing Lists http;//www*madaq.com/mailfnglists.html 

Macintosh 

There are several {in-line miiguzines for the Macintosh 
community (besides MaeTech, of course). You probably 
already know about MaeWeek, but did you know that it is 
available on-line? In case you don't know alxHit MaeWeek. it is 
a weekly magazine that was often referred to as the way that 
one hand at Apple knows what the other hand was doing, and 
there is some truth to the joke. You can find it at: 

Mac Week http://www.zdn e t com/ ~ maeweek/ 


issue is September (when I'm writing this column), and the first 
i.s.syc h;is sevend good articles. 1 hope iliai by the time you 
read this it will have deveb|>ed and the content w'ill lie even 
better. Check it otit t()r yoursell:^ at: 

MacMagazine http;//oeDnline.com;80/-'tomk/MacMagazine/ 

A site that has l>een around for a wTitle but is a good site lo 
check out, Ls the ULTIMATE Macintosh, This site has links to 
tons of stuff. A gotxl place from which to branch out into the 
Mac i nt< )sli 11 n [verse on the I ntern e i. Bm nch out from: 

The Ultimate Mac http://wwwJreGprcss.conn/myee/ultimate_mac.htmI 

Neat NON-MACim osii snvs of the Month 

Keeping with the theme of electronic magazines, I Wf)uld like lo 
draw your attention to The Feed. It is a fully electronic 
magazine (no prim c(Hinrer-parr) and is a view of what 
interactive pubILshing ctnild lx: like in the future. Some very 
notable iXHjple contrihute to nie Feed and yt>u can interact with 
them through Tlie Feed. It Is a profe.ssional magazine, well 
layed out, and with g(Kxl content. Highly recommended ai: 

ThG Feed http://www.emedia* net/feed/ 

For those d' you not in the Silicon Valley, you might w^ant to 
<Tieck out the San jo.se* Mercury News. T1iis is an on-line vcn>ion 
a newspafXT that ccjvers the Silicon Valley. Tliese are the .same 
petjple tliat bring you Mercury Center on AmeFk:a On-line. The 
top stories and index are free, ixit there is a sulxscrif>tion t Ixirge 
to see everything (though it is a \o^ less than sul>scribing to die 
paper itself). They also have a service railed NewsHound that 
can autuinatic^ally sc^iin ihe news for key words and .send you the 
articles. A start at agent tecTmology. Read the paper at: 

Mercury Center http://www.sjmercury.coin/ 

Well, that's it lor this month. As aways, if you find 
something interesting, or luive update.s, send them to 
UR t.s@ M acT ech .com 

Thanks to, ami many others for their t:oniribvjtions for their 
suggestions and pointers Lo new and old sites. A[)ologies to Jon 
Pugh for misspelling his name in the .SeptemlxT issue! 

iNTl-RNET-RELATEn MATERIAL 

Apple Internet mailing lists http://abs.apple.com/appleHnterret/ 

Bolo httpi/Zbolo, nc5a.uruc.edu/ 

Clay Basket http://www.hotvvlred.cofn/staff/useflafvd/tlay/ 

Consensus h iip://www.consensu s.com: 8300 

C U -SeeMe http ://www]urigfe xom/msattlef/sd-tedT/comp/cO -SeeMe/ 

DigiCasb h Up://www.digicash .com/ecash/ecash- home, him! 

ForeFfont Group (GrabNet} hnp://www. Ifg.com/ 

Info-Mac Searcher http://www.mid.net/lNFO'MAC 

Inte rnel Conf i g ftp://ftp.sfraf e corn/pu b/intemet confi gu ration/ 

InterNtC http://www.tniernic.net/ 


Another new on-line publiaiiion is MacMagazine* It's first 


58 


llNiFORAt RF^UHa: Lik:aiohs 


MAt:TEtiiJVlAc;AziNF: • NovHMRFif 1995 












The Scriptahle Database Client 


DataScript is probably the quickest, 
easiest and most cost-effective way 
to make your integrated AppleScript 
solutions database aware - today. 

DataScript can he purchased from. Gencnd Knowledge by phone, 
fax or INTERNET' using VjSA/Miisteraird of American Express/ 
DataScript is also available froin the Mac'Iech Mail Ordej- Service 


quickest. You can make new or existing seripttxl solutions dat;ilxise 
aware in a flash. It takes just six lines of AppleScript to fetch data from 
an industry standard datalrast^ maniigeTuent system such as Oracle, 
Sybase, DB2 or Iiifomiix. We ihmk Ire plexsed with it’s 
perlbmiance ttx^ - it launches in an instant and Is available accelerated 
for PowerPC. 

easiest. DaiaScript’s scripting vocabubry or terminology is easy to 
learn, easy to use and easy to rememIxT. If yoiiVc done any scripting 
before then you'll be running with DaiaScripi in mi lime. If you're new 
to AppleScript don't worry - ‘‘Inskle l’)a[aSi ri|>t'' ctMitains lots of easy to 
follow script snippets which you can reuse in your own solutions. 

cost-effective, Becau.se DataScript is so easy to learn and easy 
to use you’ll income produclive very, veiy quickly. Once you’re^ ready 
to ship ytrur finished database aware solution you'll find imr licensing 
schemes very attractive. 

Teluplvone +44 m2 746 026 
Ftu ^4 1202 715 600 

INTERNET kfiowlcdgnl >le<2&appleIink.appJe,com 


ISP FAQ http;//www.amdzing.com/iniefnet/ 

ISDN page http://abmni.caliech.edii/-dank/isdn/ 

Peter Lewis http://w ww.sha re.com/peteriewis/_ 

see also _ftpi/jfip .shar e. corn/pub/pete rlewis/ 

see also ft p://amu 9 .org/pu b/peterlewis 

List of Mac M a i I ing Li sts http://www.madaq.com/itial lingl ists.htmf 
Lycos (Index of the Interriet) httpi/wwwJycos.com/ 

MacKITP (see also WVVWf 

Mailing List http://www.biap.com/machtip/mailing_iisl.hlml 

Registry http://Www.batneLcom/ape/machttp_talk/ mach t t pservers. by. mac.html 

Extending MacJITTP 

iittp://www. uwtewash] ngton .edu/Computi ngA/W VW/l.es5ons/ST ART_H ERE .htmt 
Mac Web http://gal axy. el net, net/E I Net/Ma cWeb/MacWeb Horn e. html 

Matthias Neeracher http://err.ethz.ch/members/neeri.html 

M ER IT Sea rcher htlp://pubweb.nexor .co. uk/pubi ic/mac/archive/welcoTne.htm 

OpenTransport/TCP gopher ://seeding. apple .com 

Outland rtp://ftp.ouTlandxQm/ 

Portable Net. Greeks h ttp://sunsite. Linc.edu/-boiJtel 1/^. html 

SaiptWeb hftp://www.gz.com/saipTweb/ 

Eric Sc outen (TCP) _ http://www.metrowerks.com/tcpip/index.htmt 

SGML, Info http;//www.siL 0 F 9 /sgml/sgml.html 

C Parser ftp://ftp.jclark.com/pub/sgmfs 

C++ Parser itp://ftp. j da rk .com/pufa/sp/ 

WWW, Jon W. Mac WWW Development Guide 

http: //www.uwtc. wash i ngton .edu/Com pur in g/WWW/Mac/Di reaory. htm I 
CGI demo/infd http://diafloiie.acns.nwtj.edu/malltools/ 

ftp://acr^s.nwu. edu/pub/jlnstuff/mailtoois/ 


Intro, to WWW hnp://www.eiLcom/weh/www.guide/ 

Web66 http://Web6G.coied.umn.edu/ 

_ Non Mac servers _h^:/^vwvw.w3.org/hypertext/WWW/libray/Status.html 
'Vahoo (Great index of the Internet) ' http://www.yahoo.com/ 


New Teciiiiologies 


ADCE 

ftp y/ftp.andiew .emu. edu/puh/aoce/ 

http J/www.ctMil r ib. andrew.onu.edu/usr/ibbt/aoce/aoce.hlml 

Apple, ftp 

rtp://ftp.info.apple.com 

Web interface to ftp http://wwwJnfo,apple.com/cgI'bln/lister-pl 

DTS 

http://www. info.app le. com/dev/dts. htm 1 

Tech Notes 

http:// WWW. info .app io. com/dev/technotes/Main. h t ml 

see also 

http://www.austin.apple.com 

Apple Guide 

http://www.guldeworks.com/ 

Dylan 

http://Www.ca mbr idge. apple.com/ 

see also 

ftp://cam bridge .a pple.com/pub/dylan 

see aiso 

http://legend .gwydion .cs.cmu, edu :8001/dylan 

see also 

news:/comp. fang.dy Ian 

Mailing list archive 

ftp:/7cam bridge .apple.com/pub/dylfln/m ail-archive/ 

Mariais 

ftp://f tp xis. ufLedu :/pub/src/M aria is 
http://wvvw.cis. uH .edu/- jnw/Ma rl ais/ 

Mindy 

ftp://ftp.hdt .com/Zhome/bea rd/M indy-P PC .sit. bi n 

Kaieida 

ht tp:// WWW. kalelda .com/ 


OpenDoc/Rento/SOM hnp://www.ci!abs.org/puh/ciiabs/tech/ 

ht tp://www. info. applc.com/dev/du/intro_to_opendExyiodO Jndex.htm I 
Open Doc Part Ideas 

_http://www.eng .ud .edu/-sroussey /Nel V ision/software/od parts/ 


Coruinued on 62 


NOVRMBEH 1995 • MArfTECHMAGAZtNT 


UniI'Ohm Rt:soi!K(:K Uk:atgrs 


59 












































By John Kawakami, MacTech Magazine Editorial Msistant 


CodeWakrjor 7 Dfiivers 

The aniieipaied CodeWarrior 7 has shipped, CfxleWarritK now 
comes on two CDs - Tools and Reference. Tliey are desi^^ned 
so that you can install from the Tools CD, and pop in the 
Reference CD for, doeumentalion and information. 

The CcxleWarrior IDH now ha.s new Target preferentes, 
with Plugin preferences for languages (C/C+-^ and Pascal), 
target platforms (Mac 6m, CFM 68K, PPC, Win32/xH6. ami 
MagicCap), anti tools to import frt>m other formats, such as 
MPW lil>rar!es. The installer will in.stali all the correel files tor 
each platform you cht>ose, including suiLionery. 

Other changes include improved access paths, mod date 
checking, miiltibyte characters in commcnt>s strings, 
Pnahle/Disahle Debugging (jplions toggle the Kun/i>ebug menu 
item, debugging for non-applications, and searching in the 
Message window. Hie 68K and Powerl^C debuggers have iK'en 
merged; debuggers Win32/x86 and Magic Cap are still separate 
applications, liut they all work in [imch the same %vay, 

A new debugger nub, named Meironuf) also makes it's first 
public appearance on CW7. It is intended to replace 
DebuggerlNIT and PowerMac Debug Services. Metronuh is a lal 
binary on stertods: it supports h8K, CFM6HK and PowerPC 
delnjgging .services. 

Changes in the C++ compiler: .support for RTfl and new' 
cast expressions, better error messages, new virtual function 
ilispaich method, more efficiani class layout, improved ecxle 
general ion for inlines, .siipp<m for throwing exceptions with 
destructors, multiple exceptions, new pragmas for 
import/export, and new' reserved 0+ keywords. 

Warning: All C++ libraries and all precompiled header files 
must be regenerated f<jr ihis version. 

Pascal improvements: Pascal is avw available as a comj>i!er 
iool in (he CodeWarrior IDh. for the Mac OS only. Includes 
new ty[)es: IJNSIGMKDWOKD (l6 bits) and LfNSIGNhDLONG 
(32 bits); new' funaiori: ReadString, which gets ii.s input from a 
diameter string and can convert characters to different typt'S; 
and PACKRD ARRAY OF CHAR can now lx-' mixed with the 
STRING type 

68K improvements: Links all compiler-generated ixxle and 
Tinabie to inline” code into .segment 1, links very large projects 
faster. 

PowerPC improvements: Smaller viables, smaller and faster 
C++ code; new preference for storing static data in TOC, 
FMADD and FMSIJB instructions, and traceback tables. 


Supports pipelining for 601, 603 and 604, new intrinsic 
functions, links very large projects Faster, new Linker preference 
controls link memory/speed tradeoff, other optimization and 
code generation improvements. Makes source-level debugging 
info for inline and template fumiions when "Don't Inline" Ls 
selected. Allows you to throw exceptions from Shared Lil^mries. 

Debugger improvements: the debugger is now a single, fat 
applicaLk>n tliat debugs 68K and PtrwerPC code in either C or 
Pascal. Now has support for del>ugging C++ exceptions and a 
menu item to turn this featua" on or off. Also comes witli a new 
debugger nub, MetroNub, to replace both DebuggerlNff and 
PcjwerMac DebugSer\'ices, 

PowerPlant improvements: LString clas,ses for Pascal strings 
improve string-handling; new array classes; and new pane 
classes: LI con Pane, LGrotiplitJX, 1.'Text Button. In the 
Hxperimental folder; new table classes for iiiuliiple selection, 
variable-sized rows and colLimns, and dilTerent storage models. 

Constructtir improvements: Entirely rewritten in 
PowerPlant, contains Views, Text Tniits and Custom Pane Types 
editors; many tools for editing PPob.s including layout and 
hierarchy windows, automatic Tab and Radio Groups, new 
classes on Tixils Palette. 

In addition to the alxwe, llierc are more improvements to 
other parts of the distribution. For more information, 
Mclrow'erks, email: info@meirowerks.com, 


FaNTASM AsSFMBi Ftt 

Programmers kKjking for a Um nist assemlx'r will want to try 
Fantasm from IJglitsoft. Ligthsofl claims ‘‘In tests against MPW. 
Fanrasm was many times faster and produced ctxJe that was 
only a fraction of the size of that produced by MPW. Example: 
for a sim[:>le Macintosh editor based on te, Ml’W generated 82k, 
Fantasm generated 18k." 

Version 3-20 of Fantasm wa.s released recently, and all 
rcgistCTed owneni of 3.xx should have the latest version. If you 
are a registered user and have not received die update, send 
email to l(X)623720@compuserve.com for more information. 

If you are not a registered user of Fantasm there’s a demo 
version, V3.20 (Unreg), available by ftp from: 
ftp://ftp,demon-co.uk/pub/mac/fanEasm 


The OpenMac Free OS Devttopers Maiung List 
There's a new mailing list dedicated to the technical aspects of 
porting different UNIX flavors, such as Linux and NetBSLl 
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(rufurrcil ii} here a.s ilie 0[x:nJV1iic pmjccls), to the Madntcxsh 
and PowerMadneexsh hardware. 

Operating system developers need inlbrmation ahnjr tfie 
.speciali^'ed hardware and low-levd driver software in tlic each 
Macintosh line. Until now, Apple has been slow to volunteer 
this inlbrmation, and tliis mailing list attmempts to address this 
problem. Since the Open Mac projects are dcdk'ui.ed to the o(x:n 
exchange of information and source code, there is little 
likelihood of signing non-disclosure agreements. 

The primary reason for this mailing list Ls in enc:otinige 
discussion toward f)uilding l)eLter relations between the 
different OpenMac teams and those people interested in seeing 
the projects succeed. * 1*0 this end, their goal i.s to maintain a list 
of specific information that can be prescnied u> ialcreslcd 
parties W'itiiiri Aj^ple. SfKxifically, we encourage participation 
on the OpenMac homepage descTibed l>elt)w, and contribute 
your specific needs or soluiinn.s to the inditmed prn!>kms. 

The list niainUiiners emphasize that it*s not a discussion 
group for feature requests or software support in the OpenMac 
OSs. For such informatir>n, browse the Web pages listetl at tlie 
URLs 

To subscrilx; to the OpenMac mailing list, you need to 
send mail to majordomo@punia.bevd.bhcksburg.va.us with no 
subject and with body “sulxstrrilx.^ opcnmac’’ on a single line. 
After your mail lias been sent, you should receive an 
acknowledgement of your request, and short guide on using 
the lislserv. 

The primary online restjurce for die OjK-nMac ListServ is 
kx'ated at: 

hnpy/puma.bevtLblackshurg.vaAis/opcmmac/ 

More infonnaiion cm tlie MacLinux or MacBSD projects in 
general is on the following pages: 
hnp://nucleusabgAiu.se/maclinyx 
blip://w w w. ncif )sd. c irg/Ports/macbHk/ 


(ANOnuiR) PDA Developers Conference 
Creative Digital fnc., publishers of PDA Developers magazine, 
is pleased lo announce FDA Developers West ’96, a technical 
conference designed to give developers that are cremating PDA 
produces: 

• an in-depth technical understanding of the most popular 
hand-held platforms and their development en v iron men Ls- 

• a l)road overview of tliird-party PDA development tools and 
products; 

• crucial information about what if rakes ro .siKX'eed as a Pf)A 
soft ware developer; 

• insight into wireless technologies and the service providers 
that are looking for development partners; and 

• a glimpse at new, exciting technologies tfiat will liave an 
impact on the PDA market. 

The first day of lire conferent:e consists of full-day Lulorials 
on Magic Cap, GEOS, Newton, and Psion development. 'Ehe 


second and third days include tracks on wireless development, 
advanced programming topics, the lousiness of sirfiware 
dcvelof)nienL. and new tedinologies, plus keynotes l>y; Khcng 
Juo Khaw, general manager, handheld computer division, 
Hewlett Packard, Singapore; Andy Seyhold, noted wireless 
industry analyst and editor of Andy Scylxdds Outlook; and Jeff 
Hawkins, Chaimian and founder of Palm Computing. 

There will also !>e ongoing developer tcxils exhibits and 
demos all three days. To maximize attendee flexibility, there 
are separate registrations for Lite tutorials and the second and 
third days of the conference, PDA Developers West is 
.scheduled for January 14-16, 1996. in San Mateo, CA, 
following the San Francisco MaeWorld Expo. Individual 
lulorials are $150 imtil Nov. 30- Conference registration starts 
at $375 for both days, induding breakfast and limch. 'Fhere 
are reduced rales for people wlto register for txjih a tuumal 
and ihe conference, student rales, and reduced rates for 
mulli]>le attendees from tlte same company, licxjm rates at the 
Dunfey Hotel, where the c'onfenmce will Ik; held, start at $72 
for a single or double room. 

Further agenda and registratitjn details c'an Ik* found on; 
CompuServe (GO NEW'I VENS. Creative Digital library), 
American Online (Compuling/PDAs/PDA Devek>pmcnL/New 
Files), eWorld (CO NEWTON/Llanxi D)ungtVSample CcKle/New 
Piles), and ftp: //newton. u iowa .edn/suhm iss it >ns. 

hook for the files FT)vWsi96.siL and PDvWst96.zip, or 
con tact Creative Digital inc. for more information. PDA 
Developers West ’96 Ls produced by Creative Digital Inc., and 
sponsored by General Magic, Inc. Creaiive Digital inc., 293 
CorlieiL Avenue, San Francisco, CA 94114, 
phone: (415) 62M252, email; cdi@cdigitaU'om 


Peregrine, a Prograph Ojent/Server Deveu)pment T(k>l 
Peregrine is a rapid application clieni/.server development 
environment built on tlte power ol' l*rogra|>h CPX, a visual and 
o!>ject-Qrientcd progratnming Inaugae for the Macintosh. In 
addition to a sophisticated development enviTf^nment, 
Peregrine has a fikl featured intt:mal SQL database engine for 
l)uilding standalone of client/server dataliuses. IXwelopers can 
create databases and applications w ithout ever being connected 
to the target server. 

Peregrine is offered in two versions. The Developer 
version is $1495 and supports Butler and dtF servers. The 
Corporate version is $2495 and includes connectivity to niulii- 
iLscr servers such as Oracle and Sybase as well. These prices 
include a subscription to email teeh suppon and three CD 
ROMs containing upgrades and information. Pictorius Inc. 
(800) 927^4847 
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IrSiYHSm' 

It’s not just the basics anymore ! 

Advanced courses from Developer University 
get you up to speed quickly on new Apple technologiess 

□ OpenDoc 

□ PowerPC 

□ Newton 

□ Graljhics/fmaging 

□ Apple Guide 

Courses Available as 

m 

Sclf'Piiatl Classroom Lecioit Otilimr 


For more deiajlcfd informatian^ dicclc out our World Wide Wb pages, 
http ;//%ww,Liifo,applc. com, or contact the Apple Developer Universi^^ Registrar 
at (400) 974^97 or fax (408) 9744)544. 

Dei-ebpcr Llabt^rslty, Apple Computer, Irtc, I InFirLiie loop, MS 505’lTLi, Cupeftinii, CA95014 



fTi TM 

PowerTap 


The PowerTap API brings distributed computation 
to ytTur application and makes it as easy as a simple 
black box. Divide your job into tasks, submit the tasks 
to the PowerTap API and then request task results. 

Whether it’s ray tracing, chemical design, video 
special effects or number-crunching in another field, 
your computations can most likely be done faster by 
inulilplc machines. 


* Easy-to-use API • Thread Manager Enabled 

■ Robust ♦ Supports native, 68K and 

• Compatible A4-based software. 


Emerson Kennedy 


(800) 297-3888 

po wertap @ aol ,com 


PO Box 2530 • Redmond, WA 98073 


OpenTransporUTCP 

gopherZ/seedi ng.apple.com ' 

ftp 7/seeding a pple.com/ess/pub 1 Ic/mactcp/MacTCP_Dev_Kit 

Open Transport and PCI http://pi]ot.njin,net/~msproul/ 

PowerPC 

h itp://power .gbba in ews .com/ 

Quidtdraw GX, Apple 

hi ip://www. i nfo .appl e.com /g x/gx,html 

Farviluh 

h n p://afi [i .r esidentes. u la va 1. Ld/C|uickgx/qu kkgx.html 

Lawrence D'Oliveira hnpdfwmtZ . wa i k a! o. ac. n//1 do/gx/i ndex.ht ml 

Quicktime 

http7/q uicktfme.ap pie. coni/de velop, htmt 

see also htip://www. into .apple .com/dev/devinfo/quidctirne/quicktime.html 

Tallgent 

htTp7/www.taligent.com/ _ _ 

Other Programmer Resources 

4D 

http ://Www. rretf. Qrg/4d/4d,hf ml 

ACIUS 

ftp://ftp.dnal.com/pub/adus/ 

Ada 

ftp://ftp.seas.gwu.edu/pub/ada 

Animation Class Library 

fipJ/ftp.vinual3y.mcnet.ch/virujalfy/ 

Applescrjpt 

ftp7/gaea.kgs.ukan5.edu/applescript 

http7/www.gz.com/saiptweb/ 

BMUG 

hitp://www.bmug.org/ 

Brian Bechte^l 

h it p://www. inf 0 . apple com/dev/geeks. htm I 

forth, M0PS,Yerk 

h ttp://Www. netaxs.com/-jayfar/mops,fi tml 

MOPS 

ftp: //taygela.of.nps.navy.mil/pub7Forth/Mops 

York 

ftp: //astro,uchicago.edu/pub/MAC/Yerk 

Fortran to C converter ftp://alumrii.caltech.edu/piJb/Mac_F2C/ 

Free Development Systems Faq http://vvvw.europaxorTV -sf/fdsnri.ht^ 

Get 1 Resource 

http7/www. aseL udel.edu/- haynes/g 1 r. html 

Grants CGI framework tn C http://arpp 1 .carleton,ca/grant/inac/granUcgi/ 

Robert Lentz http://www.astro.nwu.edu/lentz/mac/programmmg/home-prog.htiTil 

Usp, MCL 

hnp://www.dig]tool. com/ 

General 

http://www.es. rochester. edu/u/m lller/a lu. htm 1 

MacHack 

http://WWW.machack.com/ 

MacTech 

h Up://WWW, mactedi .com/ 

Matthias Neeracher 

h ltp7/er r, ethz .c [ V members/neeri .h tm 1 

Matthew Xavier Mora 

http://xa vier, sr 1. com/umpg/um pg. h im 1 

nidt.c (good for beginning Matintosh programmers 1) http://www.pitt.edu/-nick/ 

Parse CGI OSAX 

bttp://marquis.tiac.net/software/home,htnnl 

Francois Pottier 

http://acacia .efis.fr:8080/home/pottief/index, html 

also 

news://com p. sys. mac.digest 

Digests archive 

ftp://ftp.dartmouth .edu/pub/esmp digest 

Prefab Software 

http ://www,tia c.net/prefab/ 

Jon Pugh (AppleSaipt) 

ttp://ftp.netcom.com/pub/jo/jonpugh/homepa 9 e.hunl 

http://www,infoworkshop.com/-jonpugh/default.himl 

Paul Robidhaux 

http://wwwiairgate.com/paul.shtml 


Source code, Apple htlp7/wwwjnfo.3pplexom/dev/devinfo/macsourcecode.htm1 

also Apple hitp7/www.infQ dpple cQm/dev/ so<jrce/inctex.html 

also UMich ftp://mac.arciitve,umkh.edu/mac/devebpfnenUsoLirce/ 

also M. Meeracher hp7/ftp.switch,ch/softwdre/iT)ac/&rc/HTMLAWelcome.html 

Christopher Tate hnp:^^world,sid.£om/“Ctate/mac.htiTil 

T Cl ftp 7^dae mon .nesa. ui uc.edurr C L/ 

see also http^/fhino.harvard.eduydan/TCLArchlve.html 

TopSoft hnp://www lopsoft.org/ 


XCMDHideout http:/Avww,nnnc. Gulb.edu/brendon/xcrndhideQu t/xcrTidhideouthtrnl 


Vendors, Products and Miscellaneous 

Absoft 

http://www.absoft.com/ 

AJaddin KASP 

Aladdin Systems (Sluffit) 
Alpha (text editor) 

http:,//WWW.hasp, com 

http://www.aladdinsys,com/ 

http ://www.G.umd .edu/ - keleher/aipba.html 

BBEdil 

http ://www.tiacH net/biz/bbsw/ 

MacHax Group 

http7/www,hax, com/ 

CastTerh viriual rastings 

hi tp://www.casl ec h .fi/ 

Celestin 

htTp://w^.celest in.com/ 

Ceneca (PageMilf) 

Chris W. Johnson 

http://www.ceneca. com/ 
http ://garg rava rr.ee. utexas .edu 
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CIL 

http ://www,cilabs. org/ 

Cyno Technologies 

http://www.cyno.com/cyno 

DIgitool 

http://vi/ww.d igitool .com/ 

Oilbcft 

http://www.unitedmed ia com/com ics/di Iber l 

Oraginstall 

http://www.sauers.cam/draginslal 1 

T om Engel http:^/gasn ei.med.yale. edu/demos/Tnm*s_Madntosh_Page, htm 1 

Erogonomics Web 

hup://tuck ef. met h .utah, edu/ 

EduPage newsletter 

mail ro:lisiproc® educom.edu 

in the body of the rnessage pul: subscribe edupage your name 

Evatac (Predilor) 

h 11 p://www.access.digex .net/ - evatac/ 

Graphical Business interface http://www.gbi.com/ 

Genefal Magic 

http://www.ge nm agic.com/ 

Globa! Village Communication http;//www,globalvillage.com/ 

Iconix 

httpV/www.biap.com/lconix/ 

Steve Jasik 

http://www.lasik.com/ 

Just Sonxe Guy 

http://www. 5 pies.com/greg/ 

Language Systems 

htip://www. langsys.com/langsys 

FTP site 

ftp://cais.com/pub/l 3 ngsys 

LPA Prolog 

http;//WWW. Ipa. co,uk/ 

MIND/MacDNS 

hi tp;//cybercmnx J ech wood .org 

MacMagazine 

h ttp i/Zoeonl i ne.com MI ~ tomk/MacMagazinc/ 

Maciritosli Vendor DitectiMy tiTtp://w\ww.madaq.comAendor.html 

MacUnQ 

hrtp://Www.wsmithxom/madinq/ 

MacNet journal 

http://www.dgr.com/web mnj/ 

Mac Nets witch 

http://www.nd .edu/ - dwa tioo 1 / 

MacNosy 

ftp://ftp.netcom .com/puh/ma/macnosy 

MaeWeek 

http://www*zdn etxo m/ - ma eweek/ 

Metrowerks 

http://www.metro werks com/ 

Motorola 

hnp://www.motxom/Power PC 

MaviSoft 

http ://www,navisoftcarn/i ndex. him 

NeoLogic 

ht tp ://www.neologic .com/^ neologic/ 

Newton Source 

http://wvwv. ne wtonsou rce. com/ 

Newton 

http ://newion. uiowa, edu/ 

PACE 

hup ://p3reap .com/pace, htm 1 

Piclorius (Ptograph) 

http://192.219.29,95/home,html 

QKS/Smalltalk 

httpV/www.qks.com 

QUED/M 

ftp://ftp,nisus-softxom/pub/nisu5 

see also 

httpJ/www.nlsus-soft.com/~nisus 

QutckCam http;//www. jung Ee .com/msattler/sd-iech/comp/hardware/quidcam. h im 1 

Rainbow Technologies 

hnp://www.mbo,com 

RTFM Productions 

http://rampa9e5. onr am p, nei/- r Ifm/ 

Semper Fi mailing list 

mail to:l istproc^a bs .apple.com 

(n the body of the message put: subscribe SEMPEft.fi your name 

StepUp Software 

hltp://f arnpages, onr a mp. r>et/-StepUp/ 

Summit Software 

hi lp://wvwv .summsott.com 

Symantec 

http://www.sym antec^com/ 

Tenon [MachTen Unix) 

http://wwwJenon.com/ 

bdBlTS newsletter 

http://Www.dartmouth. odu/pages/TidB fTS/TidBITS. htm 1 

see also 

ne ws://cQmp. sys. macd igest 

to subscribe 

mailto: (nfo@tidbits.com 

Time Tracker 

http V/www. ma ui. ca m7~b i Urn 

The Ultimate Mac 

http://www Jreepressvcom/my ee/u Iti mate_mac. htm 1 

UserLand AutoWeb 

http ://www. hotwired .com/Slaff/user land/ 

Verb Finder 

ftp://gaea.kgs.u kans.edu/f rori her/oldst ulf/VerbStack .si t. hqx 

VIDI 

http9/9f8imon.i3ltedi.ediiAndi/vjdi4iom£page.htii]l 

The Well Connected Mac 

h tip://WWW, maefaq .tom/ 

Working Software 

h ttp://www.webcom jom/-work] ng/0 E M .html 

# 

Visit MacTcch Magazine’s Web site! 

http://www.mactech.com 



criptWizard 


Version 1.5 

Now shipping. With all rhc new features that ytiu asked for. 

Script Wizard^” is the best-selling C^A/AppleScripc script-editinfi 
and debugging uhiI iltai ctnuhities the power of a pTi(re.ssional 
development envinmment with the ease of use that you expect of 
Mac int(.^h®stiti ware. Script Wizard improves your paxluctivity by 
deliverUig testU^ and debugging facilities tliai are as intuitive as 
they are powerful^ incUkling a Variable Watcher, true singlostep 
debugging, rapid script navigation, and more. 

Mew features.,. 

• True AppleScript statement-lcvol sing(e stepping, 

• Scriptahle and Recordable, 

• Improved text editing, wttii drag and dn>p. 

•’'Native" fnr hoth Power MacinloivK and f>SK, 

• Ouick access to Dictionaries from a new menu. 

• Full control overToi>lhar [xisitiori visihiliry, 

• Re-sizable panes in windows. 

■ Pfojecior-aware. for source cotle o^nfrol. 

• Edit and debug scripts for FaceSpan 2,0, 

• and nujch, much, more... 


Upgrade 

^9 

US prif^e 
still only 

$99 



US Orders: 800 232 1560 

Td; 510 841 6484. Also st,W h, APDA & MacTcch. 
Full Moon Softwiire, liiicrnet: cellin' 

Intermitioniil Ortlers: Tel i 44 I62fi 6 (j0242. Rix 




Can you spot 
the difference? 


Plenty of Kccjmsc whedicr you update software with a 

full set of pmgram dLsks, tjr a file made with IlpdaieMakef 2, the reailt 
Ls die siime. Guaranteed. UpctaieMaker updates arc uxally reliable 
Its system of 32 bit checksums ensua’s that it updates the right file. 


And I IpdateMaker Ls easy-to-tise - simply specify the files and 
UpdateMaker builds the update. Tlxere Is no scripting or use of 
Res Edit. It's even easier for end users - just one Ixutton to press, 

lI|KkteMaker 2 works with any type of Macintosh file. The uptbter 
files are extremely COittpact And die program optit^ms numerous. 
You can preserve or override aser eustomisatioas, Save files in Hinhex 
fonnal. llpckite up to 20 dd versions wiUx one file. 


Tilt real difference is the .savings in time and money. Which 
explains why some of the liest-known names in .software 
development have already discovered UpdateMaker 2, 



Distribution is uorestrkletl anti royalty-free. 

Only $225, order now, fax (415) 964 2886 

.\ppl«link:MjcLali007 lnlerniiJbclaM07tAppkUokJVpplc4»ai 


UpdateMaker 2 


.ADInsdruments, 2225 Grani Road, Suite # 4 , Los Alto*, CA 94024 Phone: ( 415 ) 9 h 4 2878 
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MacRegistry" 

Developer Job Oppor t un i ties 

U you are a Macintosh developer, you should register with 
usl We have a database that enables us to let you know about 
job opportunities. When we are asked to do a search by a 
client company the database Is the first place we go. There 
is no charge for registering. The database service is free. 
Geographic Coverage is nationwide* , 

Marketability Assessment - To get a specific feel for your 
marketabil ity send a resume via Email or call. You may also 
request a Resume Workbook Sl Career Planner. 


Discreet “ We are very ciireful to protect the confidenliality 
of a currently employed developer. 




Scientific Plaeemcm is managed by graduate engineers, we 
enjoy a reputation for competent & professional job place¬ 
ment services and we are Mac fanatics. 

l-H(M*-231-5920 • das@spixom • Fax l-8fK)-7S7-9003 
http://www.scleiitif1extiin 

Scientific Placement, Ina 

m. Bojt 19W9. ^ roiiston. TX 77224. 716 300 Patij 713 0373 

MT. Box 71. San RanKHi, CA S10-733-6168 beth@!ipica.bdl.com 

MT. Box 202676, Aufilin/f’X 7K721V2676 5]2*2fiCM)l23 lej@ 7 ilkFr.iKt 

M'l', KeniYinfF Stalir^n. Bo* 15226. BcHiinrtH. MA 0(2215 617-424-8372 jenOspbO'i.pflj^Qm 

AppklJnki 016813; Cnin|m.'ienfe; 71Z50iV001; eWorld: Jtpi: AOL: davKiYtolf 


Work in 
Vatationland! 

YOU DOHT HAVE TO LIVE IN THE URBAN JUNGLE TO 
DO WORLD-CLASS PROGRAMMING FOR EXCITING PRODUCTS! 

A Financially strong, rapitlly growing software publisher, locoted in the heort of 
'’America's Vacation Ion J," is seeking strong C programmers 
with experience writing commercial products for Macintosh. 


In addition to a competitive salary and benefits, and challenging, 
high-profile work, you1l enjoy the chance to live in o beautiful, low-cost 
community just o short drive from some of the nation's premier sporting 
areas and resorts, live where most people only get to vacation, 

To opply, send resume in confidence to: 
Mark Swanson, Vice President, Software Engineering 
Advantage Learning Systems, tnc, 
PO. Box BO36, ViTisconsin Rapids, Wl S4495 8036 



advantage 
Learning Systems, Inc. 



MacTech Hsigazine 
is your 

recruitment vehicle 

When you need lo fill 
important positions al youf 
company, MacTech Magazine 
h the consistent choice of 
companies across the country' 
for hiring the best qualified 
Macintosh programmers and 
developers. Let MacTeeh 
Magazine deliver your reemit- 
ment message to an audience 
of over 27,000 qualified 
computer profes.sionals. 

Call Kulh Subrin at 
805/494^9797 


Do you have a service that you want to advertise to over 
30,000 Macintosh progranuiiers and developers? 

Do it in lilt* MatTech Classifieds - 

an int*X|X!asive vchkie Uiai ge/Ls- nsiilis. 

C'ivtl Rulli Subrin jil 8^)5/49^-9797 to reserve sp;i€e NQW1 



The Trattner Network 


The Trattner Network, a digital talent .source, is looking for 
experienced Macintosh developers for a variety of consulting 
opporlunilies. CiiirenE jirojecLs include development in the areas 
of Open Doc, Newton, Power PC, Mcirowerks, PowerBtiok, 
MacApp, 4D and many others. 

We have needs for: 

• Software DevelofX-^ni 

• Hardware/Firmware Engineci^ 

• QA/Q(' Professionals 

• MulliMedia Developers 

• Project Coordinator/Manager 

• Network Profes^sionaLs 

The Trattner Network brings 10 years experience in the 
Macintosh consulting and placcmcnl industry, offering a unique 
blend of humanistic interaction and technical knowledge. 
Positions in Northern CaliTomia and Natiortwicle. 

if you arc looking ft>r the chance to enhance your skills, team with 
die liest, and make lots of money, .send, fax or link youf resume to: 

TTN 

Attn: Nyla Miller 

170 State St., Suite 240, Lo,s AltcxS, CA mil 
Phone (415) 949-9555 • Fax (4 15) 949-1026 
ApplelJnk: inn,net • email: nmiller^lrainet.coni 
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CLASSIFIEDS 


Career decisions can live with you forever. 



icipal Software Engineers * Senior Software Engineers * Software Engineers 

neic techriicatly positiofi^ wrth resparisMity for creauog jnd enhancing high-prafilc 

iie<iuii‘c obfccl-cmcnicd flui^nry .ind dcrnon^rablr x^xiwhrrirr: (foyrkiriing, cammeMTiFiil pfodurtr b one of 
rhe fnWowirvg foirwworks (in ordpr of preferenrej: HricApp Sx, l^trowerfs fbwerf’t.mt or 1 hunk Ctiss bbrary 


Technical Support Managers - Technical Support Analysts 

I fiese positioiK. waiJi lespooijbrfily for end-user troirung tind .ippiitntion suppoil. requ<re dcnricinslrablc 
cxpa itr^ictr in puUk.Lii:jon Loitfiguidljorii and pfodutliun. pi-efei'ably at Itn: Productjon Manaj^r Jevet o* atwve. 
These positrons .siso call for a hirgb degree of familianly with the use of Srstem 7.5 and M^ciritosh puhfishing 
.ipplrCti lions such as Quart Xprw.s, P.igrifirvtkoi; arid/or PhnioshopL .Sompi of ihest* posit ionr. iUie avriiLiWo .it 
Dur training facility m the New Jersey Meinkiwlamis, pu^l txjliidc o! New Yor k ULy 


Regional Account Executives 

These pDSftiom, with rrsprmsiNlily forimlLil rlirnl fmtart rind acrount roiiirilnnvinrr'^ rrrtiiire rrxtmsivo 
experietite in packaged soliWiire talcs, deally to dknli m the publiciiifTig indiEtry tx rekaLifd mjlIuis. 


nth degree software is a financially strong, rapidly growing Macintosh developer staking out a leading position in 
desktop publishing and multimedia enabling applications. We're die creators of Proteus. "The Magazine Architect", 
which otie of America's largest publishing companies has called "the most brilliantly realized publishing system since 
Quark Xpress.” (Check out the lead story in MaeWeek s 9/I8/9S GA section). Our headquarters is in the heart of the 
Toiyabe National Forest in income tax-free Nevada, just a short walk from Lake Tahoe and minutes from Heavenly and 
other South Lake attractions. If you're interested in an exciting work environment, an ^celJent compensation package, 
and great opportunldes for personal growth in a beautiful, famify-friendly community wliere most people only get to 
vacatiori. we'd like to hear from you immediately. Positions currently available include: 


Due to the immediacy of our starting needs, we encourage you (or a friend) to send 
us your resume today. Indicating the position of interest, by fax (7(J2-58&-4901) or e-mail 
(nthd^ree@sierra.net). If you are driven to achieve, we'iI take your career to the nth degree. 


Dilbert'^ by Scott Adams 




... HY FIRST ORDITING 
5FAC1 STATION WA5 HADE 
ENTIRELY FROIA OLD 
50CK5 AND VASELINE. 
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Tips and Tidbits continued from page fiO 



is a coUtxHon of five menu deRnl- 
lion resources (MDEFs) that you just 
paste into your project’s resource fik. 

Build a menu using theMDEFand 
then just handle menu selections like any 
normal menu. 



3D TvOlt ► 

Cifjprt I 

Att n than p 

THi* Veor >1 


Also contaimMaitre d\ a special menu demlomenl iml 
ihui assists liou in designing your MENU Mill. Menus. 


INFORMATIVI; CUKSOKS 

One lei'hnique that I have u-setl in the past where dropping into 
iIjc del)uggLT wasn't an option, and logging wasn't getting 
Flushed in time/took tcx) long, was to creaiie a bunch of cursoni 
numbering 00 - 99, and made a call to set the cursor and tetum 
the number (jf the previous ciirson 

routine1() 

I 

Ehort oldCursor = setTIebugCursor (15}; 

setDebugCutsor (oldCursor) : 

\ 


' Use your drawing programs as programming tools 

• Fast unobtrusive RGB color picker 

• Space saving Geneva 9 MI)EF 

• Calander Menu 


JU.ST...> 


$69.95 


Write, Ariel Publish in ft, tnc. 
1 lA Leisure Time Drive, 
Diamondhead, MS 39525 
Call (601) 255-6713 
FAX (601) 255 7086 


DHVlilXinUO HV Sn AZSOKJ’WAKK, tNf 



l:!B 


Script Debugger 

Scrip! Debufifier is a powerful and (lexible AppleScript™ autlioring toed thai makvs 
it easy for norice and exjMjriericeti scTipl wrilen; to get the most from AppleScript 


Script Debugger 

■ Offes true smglfrstep execution of 
o9 AppieSaipt scripts 

■ Pfovideso powerful scriplmg environ 
ment tlrot incyes Drug £ Diop diling 

■ Is Power PC Holtve 

■ Is scTipmble ond attochable 


Into Nighi SoftTwrt lid, 

sIQO Voke (*041729^5578 
IXT hrx {604)929-49*1 

f m®} gtibin@wimsey,com 


Whol the Scripting Gurus Soy About 
Script Debug^r 

'Do iff tk fmistsfkfelofmg mdmf 
scriHS 

S^tOexiggBrHtmfhinWimiiwi, 15 
pRynrtui aid anortod ^atxds ifr owr ?0K 
{d Ibri dbmj and k gmwng q«idtV i^Nif's 
vdien riw laiSf uppiBCkits Saipi Qdmggef* 

tmt litM, mhIhi HtiimpAg witivthr 

ImSoHil ikbug^ osmy^Staiii Sedpi 
fdijpr oadd is ttaly indispeflsoik ! espedalfy i^e 
die ppsgm's saiptdid^ mi ulHxhtMfy us 
Jtese feotm indc it Miefy cusfmif ^^' 

loi Puftl, Jf|)kScrlpl (iiiMif, mitm 9I l«v 0ini]|tt4t 


This way wiitrn the mac:hine froze, the airsor would tell me 
what routine tl had in. 


Tow Kimpton 


MPW Editor PRiMmw^ 

Ihe MFW Command Reference describes 32 editor primitives 
which may lie attached to any key sequence using the SetKey 
coiiiniand. While ihe SetKey ctmimand itself is useful, the list 
of editor primitive.s alone is useful to MPW script writers. 

Though only documented for use with SetKey, editor 
primitives may he used like any other MPW command; in 
scripts, command aliases, or AddMenu items. There are a 
couple of advantages: 

t) They only work on tht^ utiive window and have .sharply 
defined functions, you donl have U> rememlx.T any .selection 
expressions or argument lists. Compare; 


8ov(?StartDfFilG 

with 

Find • "lActive]" 

2) They’re fa.si. 1 haveivt pul a stopwatch to it, but you can 
see the difference immediately in mnning a script that uses the 
primitives and t)ne that doe.snT 

Tlie Ml^W Command reference' lists these 32 j>nMiitives, Lite 
names of which shraikl Ik‘ self-explanatory; 

DeleteCliarLeft 

DeleteCliarRight 

DeleteEndOfFile 

DeleteFndOfiane 

DcleteStanOfFile 

DeieteStartOfUne 
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DeleteWordLtfi 

DclctcWordRiglit 

MoveCharLeft 

MovcCliarUight 

MovcRnclOrijnc 

MoveLineDown 

MoveLineUp 

Move Page Down 

MovePageUp 

MoveStartOtPile 

MoveStartOfljnc 

MoveWordLcft 

MtJveWordRiglit 

SelecrCharlx:tfT 

ScleciCfiarRigivt 

SeleOEndOfPile 

SelectEndOfLine 

St‘lettljneOc>vvn 

ScleclIincUP 

SelectPageDown 

SelecfPageTJp 

SdatStartQfFilu 

ScicctStartOfLine 

SeiectWorciixrit 

SeltxlWordRight 

There are also ar least five primitives that aren't in the 
command reference: 

Sa'ollHnd 

.ScrollHome 

ScrollPageDn 

ScTollPageUp 

DebiiggerCnmmand 

1 can understand why Apple mighi not want users to 
casually drop into MacsBug fnmi an MPW script, hut I wonder 
why they chose not lo document the scrolling commands? 
Wliatevcr the reason, you should obviously use cauLu>n when 
playing with undocumented features. 


lee IMviil liimar 

Ahsqft Corporation 




Bug Tracking the Macintosh Way 


Tc'siTrack autontaies and simplifies tracking your bugs st) yt>u 
can cotK'cnLmic on fixing them. Easy to set up, easy to use, 
atid quick too! 


^ Track htigs, cliangc rcquests, tester, 
configurations, and myw 


ft Produce voncm reports and charts 
ft Autorratically route btip;i to team tncinlKTs 
ft Minimum setup lime 


ft Multiple users, fijil mrurity 


AvaiUle in September 


Vor fnDfT mlbriniiifsf), cdl or frnd r-nun to seziNiM^orKnel 


Seapine 
iware 


i Seapi 
ft Solu’ 


Scirptor Suftlranr, Ik 
IQ66SciptiK Gntn 
Mjinmlk, CM 

5a6aj.6456 


MultiQuest S‘CASE 



The Clear Choice for 
Serious C++ Architects 


Taki' ctMilml uf yoiirC-i-+ (ievcloprTO»ri( with S-CASE, a powertul dL'Mgii onvimnmcnt 
fnr today's d^nanding applHTjUidO^ Visiwlw reqiiirtmtnfo i&iog Uw IJouch 

nntatiofw (kfiwratt' C++ wtde automatically from your design. Kwp yuur iiuHlels and 
rtule in perfect 5ynchninbtaUi.iti. Call Tor yutir /W drmfl disk itnd Itnd out why cont- 
pnnieK like Mottimlii, Siufm'n& wnd AnKX:t> ivty tm SCASEL 

Key Features:^ 

■ Booch notation ji99^) 

- Real time rule checking 

" lleralive C++ cod® ganeratlcn 

• Hieran^hicat project manager 

• Mult+user 

• platform 

• Check in / dhecH oui 

• CoiOr support 


Benerits: 

- Rapid prototyping 

• Clc^rior urchileclures 

• Reusable deeigne 
Platforms; 

“ Macinlosti 

• Windows 

• Sun SRARC 

• HP 9000 



Phone (708) 397-9930 Fax (708) 397-9931 

Email 72531.2510ficompusefve.com 
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VimpmU amtituied from pa^^e 4 


The Mac’s a loy^ right^ Fine, ask them, "What kind tjf toy 
builds products like Adoix? Photoshop? What kind of company 
uses Macinlosli to build products which ctmlrilnjic to a 
annual revenue cash flow?” Coal miners riding in coal cars 
(“Got a PC? You must be unenlightened/), dumb dads 
cx)nfigiiring a PC (how many millioas of PC users are going to 
believe lliat they’re really diiml^ if they have a PC tliat gels the 
job done?), and a crazed nianiai’ taping an 80(J number up on a 
glass wall (who knows what iliis means!?!). Could really smart 
develofx^rs who build tremendously great software and make a 
gazillion bucks l>e any worse? 

Trivia Bits 

Wily is Ticks one of ihe worst low menioiy globals to act:ess 
directly on tire Power Macintosh? Hint: is $I6A divisible by 4? 

Fik)d For Thoi’chi' 

"Remove these items lx.*t:ause they am cause clutter and use a 
large amount of tnemory: QuickDraw GX and Power talk/ 
-from a pTmluci imiaUaikm ^ttkle 



ThiscouM 

beabest 

seller. 



But 

it^ 

free. 


Vbu canl; buy the Consumer Information 
Catalc^ anywhere. But you can send for it, free! 
It’s your guide to more than 200 free or low-cost 
government publications about getting federal 
benefits, finding jobs, sta3dng healthy, buying a 
home, educating your children, saving and 
investing, and more. 

Send today for your latest free Consumer 
Information Catalog. The Catalog is free. 

'rhe information is priceless. 

Send your name and address to: 

Consumer Information Center 
Department best 
P ueblo* Colorado 81009 

A puNtc service o! this publicaticwi and the Consumer Information Center of 
the U S. General Services Administration 
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Volun^^ 1: lk;kl Out 
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cumimitiil products at no ackktkxial dtuge. .All priced are 
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M.Airn-ai exci.i sivf.s 


MacTeett Magaiiaa is your excittsive soutrs 
for these specitw products: 

All Lib 2.0 Tlic premier MaeApp 3.0 tx}mpalible 
ViewEdit reptaccmenl. A pnwtirlul usef-inlerface 
editing tool to build views fur MacApp 3.D and 3.1 
Ad Mb allows subclassing of all ot MacApp’s view 
classes including adorners. behaviors, and dicing 
envlfonmenis String and text style resources are 
managed automalically Alternate display methods, 
such as a view hierarchy window, allow easy 
examination ot complex view structures. Ad 1 ib 
includes source code tor MacApp extensions lhat are 
supporied by Ibe editor - buttons can be activHled by 
keystrokes, behaviors can be attached to the 
application object, and general purpose behaviors 
can be configurEHl lo perform a number of useful 
iunctions. Run mode alloine the user to try out the 
views as ihey will work in an application. Templates 
can be created to add additional data Fields to view 
classes. Editing palettes provide Iasi and easy edrlmg 
ol common ohjects and allributes Works with ACfs 
0h|nnt Master [version 2.0 and later) to navigate a 
projeef's user inierface source code S195 

Frameworks Magazine: S3/back-issue. 
subject lo availability. 

FiaifieWorks Source Code Disk: $10 

per back issue, subject lo avdilability 

Five Years ni Objects CD-ROM: Fram^Mxks 
archives and source code from Atiril 1991 to January 
1993, plus setoeri nbied-onenled publicly available 
software and denrus. S91 j 

MAD AGON "93 CD-ROM: Ibe highilghls of 
MADACON '93. including Mike Potel on Pink, 
Bedrock. MflcApp, OODLs, and more. Slides, articles, 
riemfks. audio, and QuickTime. $95 

MAScrifit 1 .2 adds support lor AppleScript 
to ycur Matipp 3.0.1 aixl 3,1 baski appbcalions Make 
your s^iplicatiofi saiptable aid recordable by burldlnp 
on a tried and tested framework for object mo del 
support, MAScrlpt dispatches Apple events to the 
appropriate objects, creales ohjed specfllt^s, and makes 
Iramework objects like windows and documents 
scriptable and recordable. Sample application shows 
you how to begin adding support for scripting and 
recording. MAScripl iocludcs complete source code. 
Install MAScrlpt by modifying one MacApp source (lie. 
then adding another to your projed Future versions of 
MacApp will incorporate MAScripl, so MAScript 
suppr! you add now will work in the luturc. $199 

The Mjirlner BETA System is a software 
development environment supporting objed-oriented 
programming in the BETA programming language. 
BE IA is uniQuely expressive and orthogonal. BE1A 
unifies just about every abstraction mechanism - 
including class, procedure. 1 unci ion, coroutine, 
process and exception - inlo llie ultimate abstraction 


mechanism: Ihe pattern. BETA includes* genera! 
block structure, strong typing, whole/part objects. 
Tlie compiler, binary code generation, auto malic 
garbage coHectien. separate compilation, interface to 
C. Pascal, and assembler The system: persistent 
nbjecis, basic libraries with containers classes, 
plailomi'independent GUI application frameworks on 
Unix. Mac and Windows NT, metaprogramming 
system The tools available on Urrix: Itie hyper 
structure editor supporting syntax directed editing, 
browsing, etc,, and the source code debugger are 
currently being ported to the Macintosh system The 
Mjolner BETA System for Macintosh requires MPW 
(basic set) 3.2 or later. Package (xjnfadiiiig compiler, 
basic libraries, persistent store. GUI Iramework, and 
comprebensive documenlation (Other packages are 
also available) $295 


Mure Savvy includes all Savvy features plus 
Apple Event support lor all sub-classes of 
TEveniFiandler with extensive view support Apple 
Everjl support for text includes text attributes and sub¬ 
range specification. Rccordability supports additional 
actions, and coercion includes addifional types. 
Additional clieril and server Apple Events $450 


NEW Version 


■ Savvy 1.1 OSAsut^url 

includes altachabilily, 


rrjcordability, scriptebllliy. coercion, in addition to 
script execution, idling and i/o Apple Event support 
fndudes complex object specifiers, synchronous/ 
asynchronous Apple Event handling, and Apple Event 


transactions for clients and servers. I tie Core Suite 
of Apple Event obiecls is supported including the 
application, documents, windows, and files. 
Documenlaliari includes technology overview, 
cookbook, and sample code. $250 Savvy now 
supports MPW 3.1. 311 and eonimues lo support 
3.01. as well as siippoding Metrowerks CodeWarrior. 
This monlh qjiIv, special oRer » All Savvy 
verslurrs Include free copy ot Sawy QuickTime! 


Savvy QuickTime Requires Savvy. More 
Sawy, or Super Savvy. Includes QuickTime. Apple 
Event, and view lemplate support. Movies come out ol 
fhe box ready to play, edit, and reaef Io Apple Events. 
They can be included in any view structure, including 
templalcs, and are displayed irMFie scrap view Movie 
controls Include volume, play rate, looping mode, 
display style, and oUier characterisJics. $250 


Super Sawy incluttes all More Savvy lealures 
plus compile, edit, and record scripts using built in 
script editor. View template editors, like Ad Mb, can 
attach scripts lo view objects and modifiBri scripts 
are saved with the document. Script ad inn behavior 
allow quick access for executing and editing scripts 
attached to views. Text to object specifier coercion 
plus more. $700 


MacTech Magazine is your excitistwe source 
tor avaifahie back issues of SfA 's magazine, 
source code disks and assorted CD 's. Cait 
for more info and pricing. 
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Leam C on the IVIaGintosh i?y Dm Mark ttifs sel[ 
(G<x:hing book/di^ package gives you evefything you need 
m begin programming on Ihe Mauintosh. Leam to write, edit, 
compite, and run your lirsJ C programs through a seri^ of 
over 25 projerJs Ihat build on one another Ttie book com^ 
with T>^IN C - a customized version of Symantec's TH1WK C. 
the leading programming envirorrment for Macintosh. 464 
f}ages,Book/tjisk:tt4?s $31,45 

Maclntash C Proiramming Primer Volume I, 
Second Editron, Inside the Toolbox Using 

THINK C by E)ave Mark and Cartwrighf Reed. This new 
edition oi this Macintusti programming bestsclfer is updated 
to Incfude recertt changes in Macirrtosh lechnnfogy. 
including System 7, new versions of THINK C and ftesEdit, 
and new Macinfosti machines. Readers wifi learn howto use 
the resources, Macintosh Toolbox and inlerface to cr^e 
stand-alone applications 672 pages. $24.25 

Macintosii C Programming Primer Volume 
li. Mastering the Toolbox Using THINK C by 

Dave Mark. Votume II pir:ks up where Volume I leaves off, 
covering more advanced topics such as: Color 
QuickDraw, THINK Class Library. TextEdif, and the 
Memory Manager: 528 pgs. $24.25 

Macintosh 0LE2 Programmer's 
Reference: Working With Objects: 

Provides a complete reference lo the extensible protocol 
of Object Linking and Embedding, version 2.01 for 
Macinlosh System 7. Understanding ot C/Ct ( helpful, but 
nol necessary, and comes with a CD, Working Wllh 
Objects describes the visual and inferadice inferfaces that 
support the comporienl objects, provides details of the 
OLE 2,01 for the Macintosh user Interlace, addresses the 
issues of object class registration, shows how lo 
impleirrenl tfie drag and drop obiects from one application 
lo anolher, covers the Interface that exposes the basic 
emheddir}g functionality, and Includes descriptions of API 
funcrions$44HQfe $40.45 


MEW! 


C Fur Oummiesr Volume 1 by Dan Goodwin 
Finally! A iTands-on, slep^by step tutorial lor learning the 
esseiihals of programming fn C. $44Gb $17 J5 

Macintosh Pascal Programming Primer 
Volume I, luside the Toolbox Using THINK 
Pascal by Dave Mark and Gartwrighl Reed. Thistutofia! 
shows pfogrammefs new to the Macintosh how lo use the 
Toolbox, resources, and the Macinlosh interface to create 
stand alone applications with Symantec's TLIINK Pascal 
544 pages $^4^ $24.25 


Mastering thu THINK Class Library 

by Richard Parker Now lhat Symantec's long 
awaited PowerPC native compiler is here, developers are 
liking another look al IHINK. This book provides a 
thorough examination of Symantec's extensive Class Library 
and the Visuai Architecl. a graphic user interface 
developmenl tool that allows you to produce commerciat- 
Quaiily applications with a mmimum of effort A compile 
(tesa'iption fll the structure and operation ol the FCL inclurtes 
explanations ol all code generaled by the Visual ArchitecL 
any rtecessary custom code, and the operation of this code. 
Visual Architect tutorials provide you wiltr a step-by-step 
approach for simplifyirrg the devEiopmenl ol complex 


Macintosh applications. 496 pages $26.96 


by Daniel R. Carter 469 pages mm $24.25 


C++ For Dummies" by Stephen R, Davis isthealE 
in-one reference that gets you comlortable with object- 
oriented methods and up and running doing C++ 
programming! $17.95 

Learn C++ on the Macintosh by Dave Mark Alter 
a brief refnjsher course in C, Learn C»+ introduces the 
basic syntax ol Cii and object programming. Then you'll 
learn how lo write, edit, and compile your first C++ 
programs Itirough a series of programming projects that 
build on one anoliier as new concepts are introduced. Key 
C++concepts such as derived classes, operator 
overloading, and iosiream functions are all covered in 
Dave's easy-lo-loltow approach Inc Sides e special version 
ol Symantec C++ for Macintosh Book/disk package with 
3.5^ BOOK Macintosh disk 400 pages, mm $33,26 

Programming Primer For The Macintosh^ 
Vultime 1 by John Whitt Id and Judy May This book 
provides an Introduction lo Macintosh programming, 
using 0i4 as the example language, and provides 
realistic, easy to follow, programming examples designed 
lo work with either Symantec** C++ or Metrowerks* 
CodeWarrior 6'. Also inctiides one 3,5" disk with source 
code tor the programming examples, along with 
numerous, useful, public domain utilities to use with each 
compiler, mm $34.15 

Programming in Symantec U++ for the 
Macintosh by Judy May and Jahrr Whittle. This book 
will introduce you to objerJ-orrenfGri programming, the C+i 
language, and ol course Symantec Ci i lor Ihe Macintosh. 
You don't have lo be a proorarnmer, or even know anything 
about programming to benefil from this book. PrografTirning 
in Symantec C++ for the Macinlosh covers everything from 
the basics to advanced features ol Symantec C++. II you are 
a Think C or Zortech C++ programmer who wants to learn 
more about objecl^orienled programming or whaLs dihefeni 
about Symantec C++, there are chapters specifically for you. 
Includes helplui examples of C h code IM iliusfrafe object 
oriented programs. $26.95 

Symantec C++ Pmgrammiitg for the 
Macintosh, Second Edition by Neil Rhodes & Julie 
McKeehan is the peried inlrodudicn lu C++ programming 
- the most popular programming language for the Mac! 
This updated edition is the easid way lo l^o C++ in the 
Think environment, using many examples and hands-on 
coding experience. The official Symantec book, developed 
in cooperation with the Product Developmenf staff 
Provides vatuable solutions, ifilormation, and advice lor 
MPW programmers who arc migrating lo the Think 
erivirnnment. Disk includes source code from the hook and 
example applications $40.50 

Teach Yourself Mac C++ Programming in 21 
Days by Namir Clement Shammas is the easy-to-tollow 
21 day format leaches readers how lo program in C++ 
using Ihe Symantec C++ ctjmpilcr. It also shows readers 
how lo develop GUI applotions using Hie latest version 
of the THINK Class Library (ICL) targels Symantec C++ 
7.0. one of the hottest programming languages and 
development er>vtronmeiits. Discusses the basics of 
programming lot the Man u,smg TCL and the Visual 
Archiled ulility. Uses notes, tips, and warnings, as well as 
Q&A, Quiz. Exercise, and Do/UoiTt sections lo teach users 
IheCn programming langu^rgo $26,99 

Writtng Locaiizable Software for the Macintosh 


B GIobai interlace Design, A Guide to 
Deslgiilng International User 


interfaces by Tuny Fernandes, AP Professional. 
Global Intedace Design addresses Ihe issues involved in 
product developmenl for a global market with a "real 
world" focus. While cuveririg major areas developers 
should address during Ihe developmenf cycle, Tt^ny 
Fernandes provides insight into researching cultural 
differences This book examines ifie differences found all 
over the world, such as cullurat symbolism and faboos. 
and how they impact user interfaces, mm $32.35 


Taligent's Guide to Designing Programs: 
WeiJ-Mannered OhjaGt-Orienied Design in 

C++ is Hie laltgenf approach to object-oriented design. 
The Taligenl Operating Environment is the first 
commercial sottware sv,stem based entirely on objecE 
ofienled technology, Taligent's Guide to Designing 
Programs is a developer s eye view of this system. It 
introduces new concepts of programming arrd empowers 
developers lo create software more productively. Out ot 
their direct experience in developing the system, the 
authors locus on global issues ot objecl-ortented design 
and writing Cr+ programs, and the specific issues of 
programming in Ihe TaligenI Operating Environment. 
Tali gent's Guide to Designing Programs assurnes the 
reader is an experienced C++ irrogrammer, and protteeds 
from there to lully explore ‘Ihe Taligent way" of 
programming SEm $17.55 


Software By Design: Creating User Friendiy 
Software by Penny Bauersfeld (Series Editor: Tony 
Meadow), this excel tent roference provides readers wilti a 
ihorouyii how to for designing software lhal is easy to 
learn, comfortable fo operate and that inspires user 
confidence. Written Irom the perspective ol Macintosh, 
bul compatible with alt platforms. Stresses user input 
from ihilial design, through prototyping, testing and 
revision. Provides tools lor analyzing user needs and tesl 
responses. Includes exercises for sharpening user- 
oritnled design skills. $2^ $26.95 


Macifilosh Frogrammiiig Techniques by Dan 

Sydow (Series Editor Tony Meadow). This lulorial and 
handbook provides a thorough Icuridalion in the special 
techniques ol Macintosh programming for ex(>eFtenced 
Macintosh programmers as well as those making the 
Iransilion from DOS, Windows, VAX or UNIX. Emphasizes 
programming techniques over syntax for better code, 
regardless ol langiiage. Guides the reader ihrough Macinlosh 
memory managnmenl, QuickDraw, events and more, using 
sample program in C++. Disk includes an interacli^ lutortel, 
plus reuskibfR C++ code mm $31,95 


Macwurld Ultimate Mac Frogramuiing by 

Dave Mark, Bestselling Mac proymmming author Dave 
Mark reveals Ihe secrets ol Mac programming and presents 
impodanLtimesaving techniques $394^ $35,95 

Mac Screamer The Ultimate Macintosii^ 
Supercharging Kit by Jan Harringlon covers 30 
Macintosh models, Including the Classics, LCs, 
PowerBooks, and Quadras and gives software solutions 
and todware hp.s lo accelerate Mac performarree. II lets 
readers in on do-ii yourself tips that can save them over 
25% on upgrade costs. 135 00 $31.50 


Fnfn A Fragment of Your Imagination by 

UiUM Joe Zobkiw Here's some pracHcal help tor 
creating code resources and code fragments for the 
Macintosh and Power Macifitosh. Rather than simply 


For complete product info see the MacTech Web" site at http://www.mactech.com. 
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gathering and indexing chunks ci this Vila] code, the 
aulhDr provides thorough explanations lo leach you more 
aboul how Ihe Macintosh system functions as a whoie. 
He also provides hard lo find information abouL 
techniques used lo structure and build faf, safe fat, and 
accelerated code resources lor use on both 680x0 and 
Power Macintosh. All code Is reusable and is provided 
on the disc, along with Melrowerks Code Warrior Lite. 
Book/CD-ROM. 523 pages Wm $3&.9e 

Mac Programming for Dummies'^ by Dan Parks 
Sydow takes the inlintidation and work oul of writing Mac 
programs. $17.95 

Programming for System 7 by Gary Utile and Tim 
Swiharl. is a haods-on guide to creating applicallor’is tor 
System 7. II describes the new features and functions of 
the operating system in detail Topics covered iuclude tile 
operations, cooperative multitasking, BaJIaoii Help. Apple 
events, and Ihe Fife Manager Numerous working C code 
examples show programmers how to take advantage of 
each ot these leatures and use them in developing their 
applirations. 384 pages $24.25 

Guide to Macintosli System 7.5 by Don Crabb. 
Written by an industry expert, this is the first thorough 
book on the new and improved Macintosh operating 
syslem. Readt^s will learn all the highlights ol the new 
System, including how to work etllciently with 
applications. Intuitive, task-oriented approach Leaches 
topics the way users think, not the way the machine 
thinks. Covers all Ihe new features ot System 7.5. 
fncluding PowerTatk. PC Exchange, and MacTCP Written 
by a world-renowned Mac expert. $22.50 

How To Write Macintosh Software by Scott 
Knasler Is a great source for understanding Macintosh 
programming teehriiques. Drawing from his years ol 
experience working wilh programmers. Scott explains the 
mysteries and myths ol Madniosh programming wilh wit 
and humor. Ttte third edition, fully revised and updated, 
covers System 7 and 32-t)it developments, and explores 
such topics as how and where things are stored in 
memory; what things in memory can be moved around 
and when they may be moved, how lo debug your 
applications with MacsBug; how lo examine your 
program’s code lo learn piBcIsely wlial's going on when it 
runs. 443 pgs. $26,05 


Danny GooilmanTs Macintosh^ Handhuok 
Featuring System 7 by Danny Goodman witti Richard 
Saul Wurman. This user friendly design includes a unique 
tour colDf design and exploded diagrams. It includes over 
1(]0 spreads break down and clarify Mac problems and 
incItHtes insider's lips. $3 Qt9& $26.K 


pnfffl Real World Apple Guide, For The 

"" Mao is the much anticipated help and 
navigational aid componenl of the new Apple System 7.5 
OS The book is a practical introduction to Apple Guide 
tor programmefs. It explains the design and function of 
Apple Guide, how lo design your own guides usir^ Apple 
Script. Comes with a disk ol sample Apple Guides tor 
Apple Guide-compliant applications. $35.95. 


Danny Goodman's Apple Guide Starter 

Kit by Danny Goodman and Jeremy Joan itewes two 
highly respected experts otter a different approach lor 
creating your own Apple Guide databases. With 
Danny's Guide Starter program you can make guides 
quickly and easily, wilh oul having to learn a scripting 
language, write coded Hies, or use several different tiles 
and programs to produce your database (wtrich is what 


you'd have to do without the program), the authors 
provide advice and lips on how to design a good Guide, 
horn planning and creation through lesling. revising, 
and indexing. BouK/disk. 320 pages. $31.46 

HyperTalk^ 2,2: The Beok Second Edition by Dan 
Winkler. Scotl Kamins, and Jeanne DeVolo is the most 
complete, authoritative source on Hyper talk 2.2 
programming and troubleshooting tt envers each 
language element ol HyperTalk 2.2 (indnding the odd 
quirk or bug). $3150 

The Complete HyperCard^ 2.2 Handbook 
Fourth Edition by Danny Goodman is the biggest- 
selllng Mac book - newly revised and updated for version 
2.2. It shows how lo build working applicalions using the 
latest version of HyperCard and covers text, painting 
tools, extension commands (XCMDs), scripting in 
HyperTalk, and more, mm $3150 

Dan Shafer Presents the Power of Prograph 

CPX is a hands-on. proiecl-centered approach to 
learning ihe most rcvolutiunary ohject-orienred 
programming language on Ihe planet. The language Kurt 
Sctimucker likos best The language that programmers 
acluaily report having lun' programming This 550-page 
book takes you .siep by step through three inlerrelated 
proiects ot increasing complexity. Along tiie way you'll 
learn the underlying Prograph language, how lo use the 
power of lists, and the important aspecis ot the CPX 
classes and r^jecl editors. Includes disk wilh all code in 
the book. $44.95 


fWf/fn Visual Programming With Prograph 

UaM CPX by Scott B. Steinman and Kevin G. 
Carver, This is the llrsl book on Prograph CPX available 
Ihrcugh the bonk Irade It covers the only commercially 
supported visual programming [anguage at a lime when 
many progrartvnets and managers, faced wilh continuing 
pfodudivily problems, are searching lor belter programming 
cfwiroriments. Prograph CPX is much more than such GUI 
enharod traditional languages as Visual Basic: It flterally 
allows you to draw your program How using icons and 
create a complete application wiltioul writing a line ot code, 
this book is arr introduction to liie language and a guide for 
advanced users, tor both Macintosh and Windows-based 
machines. Prograph is a tufly pictorial, general-purpose, 
object-oriented language lhal sp«ds dnvelopmenl wilh an 
inlegraled environment tor design, coding, testing and 
debugging; with its 00 Iramowork for sophisticated GUI 
development; witti its support for calls trorri C, C^+, Pascal, 
and nttwr routines: wilh ils DAL, ORACLE, Sybase, AS/400 
dfent/server DB support, and many olher powful features 
Visual Programming With Prograph CPX teaches this new 
language and environment, oflering a careful pedagogic 
treatment full of usclul examples and summaries of needEd 
D(K>ceptS WtPO $30.50 


Graphic Gems V Edited by Alan W. Pi^lh is the newest 
volume in The Graphic Gems Series. It is intended to 
provide the graphics community wilti a set ol praaicat ttwis 
lt>r implemenling new ideas and techniques, and lo offer 
working solutions lo real programming problems These 
tools are written by a wide variety ot graphics programmers 
Irom industry, academia, and researdi. The books in ttiis 
series have become esse^ilial, lirr«-^vtng rods for many 
programmers tt is the latest colleclion of graptiii^ lips m 
The Graphic Gems Series written by the leading 
programmers In [tie field, fl contains at>ont 50 new gems 
displaying the most recant and Innovalive techniques In 
graphics programming. Also included is new gems in 
ellipses, splines. Bezier curves, and ray tracing Includes a 
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disk which contains source code trooi aft hve volumes and 
is available in both IBM and Macintosh versions. 
CONI ENTS: Algebra and Arithmetic. Computational 
Geometry Modeling and I ran storm at ion. Curve.s and 
Surlacas. Ray Tracing and Radiosily Halftoning and image 
Processing. Utilities S4M& S44.95 

Danny Goodman's AppleScript Handbook 

Second Edition by Danny Goodman is a seJf-conrained kit 
shows the reader how lo customize and extend the 
capabilities of any Macintosh computer nn programming 
experience needed! this enhanced and expanded edition 
ol The Complete AppleScript Handbook focuses on putting 
AppleScript to work in all sorts of practical situations. In 
addition, Danny Goodman's AppleScript Handbook, 
Second Edition shows you how to apply the same 
principles to other popular scripting systems, such as 
UserLand Frontier and OuicKeys. Shows readers how to 
use scripts to enhance the Macintosh environment, 
aulomate many processes, link data between applications, 
and much more This book provides a wcallh ot all-new 
examples showing how lo integrate AppleScript wilti IM 
Finder, spreadsheets, desktop publishing programs, 
graphics applications, databases, leiecommunicalions 
programs, utilities, arid HyperCard, The accompanying 3 
1/2* disk is jam packed wilh over $100 worth ol software, 
including AppleScript 1.1, valuable utilities, and powerful, 
ready-to-iise SCTipts. mm $35.00 

The Complete AppleScript Handbook by 

Danny Goodman is a sell contained kil lo customizing 
and enhancing Ihe Macintosh anvironmenl. The disk 
contains AppleScript 1.1 Runtime. Chang Labs 
TabteServer. and useful, ready to-run scripts It also 
shovirs the Mac user how to automate many processra 
no programming expenencc necassary. £3^ $31.50 

The Tao of AppleScript: BMUG’s Guide to 
MaGintosli Scripting, Second Edition by Derrick 
Schneider & Hans Hansen, ttiis updated bestseller is a 
cornpiete. ralural introduction tu AppleScript programming 
essenlials. Readers learn how to customize applications, 
aulomate tedious tasks, and create programs without 
having lo use a complex programming l^guagc 2 disks 
(xirilain AppleScript, QuickTirtie, Stufill Lite. ResMover, and 
other helpful utilities, Progressive structure meets the 
needs ot any Mac user, regardless of experience. 
Professional instrudions are mixed wilh practical mmples 
lor easy learning $26.95 

Wireless For The Newton Software 
Development far Mobile Communications by 

Julie McKcchan and Neil Rhodes is a book litai picks up 
where Programming lor the Newton left off, teaching the 
reader how to develop Newton*^ software on the 
Macintosh. The enclosed floppy di^ provides a sample 
application, as well as a luity functional demonstration 
version of Newton I oolkil' (NTKl. Apple Computer's 
complete development environmcnl for the Newton* 
Gives haridS'On Newton environment training with sample 
code created specilicahy lor Ihe Newton” The auihors am 
external faculty at Apple Developer University teaching 
classes on programming lor the NewlorT Programming 
experience is assumed, although not in any parlicular 
language. Enclosed is a lloppy disk which conlains 
source code for a Newton application, as well as 
demonstration NTK“. mm $3145 


NEW! 


Basic For The Newton Programming for 
the Newton Using NS Basic by John Schethoo 
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St LU O'Hara. This book shows owners q\ hiewlon devices 
how to becorrie Newton programrners using BASIC. The 
tiuthofs use a slraigtil-forward 'programming by example" 
approach, which should have you writing your own 
Newton programs right away. It inoJurtes one 3.5“ disk 
containing Demonsiration NS BASIC arrd over fifty 
example programs from the book. II is Multi-ptaftorm in 
that leaches programming for the Newton using a 
Macintosh, a Windows-based PC, or or» Ihe Newlon 
device itself $ 3d06 


Programining for the Hewtoii Software 
Development with NewtonScript by Julie 
McKeehan and Neif Rhodes, Foreword by WaltEr R. 
Smith. Programming for the Newton; Software 
DevetnpmenI with NewtonScripl is an indispensable loot 
tor Newton programnrers. Readers will learn how lo 
develop soilware tor the Newton on the Macintosh from 
people that developed the course on programming the 
Newton for Apple Computer The enclosed 3.5“ disk 
contains 3 sample Newtor^ application from the boofe, as 
well as demonstfalion version ot Newton Toolkit (ffTK). 
Apple Computers complete developnienl environment for 
the Newtons. A hjhiicalion of AP Professional May 1994, 
Paperback, 393 pp, m% $26,95 

Metrowerks CodeWarrior Programming by Dan 

Parks Sydow. Includes CodeWarrior Lite, and Full Coverage 
of PowerPlanl^". The best informalion on Melrowerks 
CodeWarrior 6, giving lull coverage to the Gold Edition 
Even if you dont already own CodeWarrior 6, youll still be 
able 10 work with Ihe examples In this book, using the 
CodeWarrior 6 Lite CD that cornes with iF $35.95 


pWffI C++ Programming With CodeWarrior 

LUiiM Beginning OOP for the Macintosh and Power 
Macintosh by Jan L. Harrington from AP Professional. 
This book shows programming novices object-oriented 
programming techniques for the Macintosh. Power 
Macinlosli, arid Mac OS compatibles, using C++ as llie 
example language and Metrowerks and CodeWarrior as 
the example compiler. Fhe enclosed CD-ROM contains 
example code from Ihe book and a futl-function 
Metrowerks CodeWarrior compiler lor running these 
examples. $454^ $32.35 


Optimizing PnwerPC Code: Programming 
the PowerPC in Assembly Language To lake 
full advanlage ol the potentiat ol tfie PowerPC, Devetopers 
need to master the Assembly Language techniques This 
book shows how to use ihe Assembly Language in 
PowerPC Programs to produce faster more robust 
sotae $35.96 

Pnwer Macintosh Programmittg Starter Kit 

by Tom Thompson. This is the ftrsl lutorial/reference 
for programmers who want to enter the new world ol Ihe 
PowerPC chips Users lind all the details ovt the new 
micropforassors, Ihe new RISC arnhileclure, and how to 
write nalive code and emulation operations to create 
Iheir own scltware lor the Macirrtosh PowerPC. CD- 
ROM includes a unique compiler for writing code 
easily. The alHin-one liook that gets programmers the 
Information and loois they need, Programminq 
examples reinforce explanafioos of code and 
programming tools $3 0 06 $35.10 

PowerBank" The Digital Nomad's Guide 

by Andrew Gore and Mitch Hatcfifte $04 00 $21.60 

The ResEdit All Night Diner by David Ciskorwski. 
An idea-filled menu and introduction to the joys of 


customizing software - and adding personality to Ifie Mac 
with ResEdit! Shows readers how to customize default 
icons, the text of menus and dialog boxes, cursors, 
pointers, and more. Provides specific recipes for doing 
Cfcahve things with ResEdll plus how to avoid protifems 
Disk features ResEdit program, plus lots of sample 
resources $34 05 $22.45 

ResEdir Cumplete, Second Edition by Peter 
Alley and Carolyn Strange. Wilh ResFdii Macintosh 
programmers can customize every aspect of their interface 
form creating screerr backgrounds and icons lo 
customizing menus and dialog boxes, 606 pages 
Book/disk package. $ 34 .05 $31.45 

Sod Maos, Bombs, Disasters and What to 
Do About Them by fed Landau comes lo Ihe rescue 
with your Macintosh pfnblcms. From fractious fools to the 
ominous Sad Macintosh icon, this emergency handbook 
covers the whole range ol Macininsh problems: 
symptoms, causes, and whal you can do lo solve Itiem, 
640 Pages mm $22.45 

Maemtosh^ Crash Course by Gtenn Brown shows 
Macintosh power users whal to do when things go wrong 
with Iheir system Macintosh Crasfi Course shows readers 
how lo overcome Macintosh system crashes, system lock¬ 
ups, and various, frustrating and cryptic error messages 
they regularly encounter. It includes a CD-ROM with 
shareware and freeware lo hefp the user diagnose and 
repair system failures Includes up-lo date coverage 
through Macintosh System 7.5, Managing memory. 
Hardware diagnostics. File recovery, PiowerBook problems, 
PowerPC problems, network utilities, hard drive repair 
utilities, SCSI problems, conflicts and soluiions and Fite 
synchronization and utilities, mm $26.95 

MuHimedia Authoring: Building and 
Developing Documents by Scoil Fisher addresses 
the concerns that lace anyone trying lo create multimedia 
documcnis. It olfers specific advice on when lo use 
different kinds of informalion architecture, discusses the 
human-laclors concepts that determine how readers use 
and retain informalion, and Ihenr applies Ihese findings lo 
multimedia documenls. covering the high-level issues 
concerning planners and authors of rmittimedia 
documenls as well as those involved in evaluating or 
purchasing multimedia platforms. Indudes one 3.5" higti- 
rierrsitydisk mm $31.45 

Muttimedia Starter Kit for Macintosh by 

Michael D Murie. This hands- on book offers Ihe latest and 
greatest in nrulti media for the Mac' Reeders learn how lo 
design their own multimedia projects step by stop, then fry 
it Ihemsdves with the denMJs, graphics, clips, and sample 
projects on the CD-ROM! CD ROM contains QuickTime, 
sound and graphics dips and utilities, sample projects, and 
mure. How fo choose and use a variety of Macintosh 
muilimedia loots and prEseotatton environments. Includes 
tfemos of Adobe Illustrator, Premiere, Heizer Software 
programs, and more $3 0 00 $27,90 

QuickTime Starter Kit fur Macintosh hy Robert 
A. Lettiefi & Judith Stern This is the ulfimafc package for 
getting productive and hiiving fun with Macintosh movie¬ 
making. Easy Steps and valuable software fjelp readers 
play, make, and edit QuickTime rnovies. CD-ROM 
includes QuickTime tools, movie ctips, shareware, and 
rifimos of Premiere and other progfams Written hy 
members of Ihe respected Berkeley Macintosh User 
Group. Tips on the bcsl ways to briny live-action video to 


Mac multimedia $ 45 00 $40.59 

Adobe Premiere for Macintosh: Glassruom 
III a Book, Second Edition by Adobe Press This 
IS The updated edition of Ihe official Adobe training 
workbook! Covering all Ihe essential teatufes of Ihis 
video editing software, this book/CD ROM set features 
iwenty tutorial lessons lo guide teachers and sludenls 
through the magic of Madnlosh muvte-making. CD-ROM 
includes QuickTime movies, electronic images, and 
Irames needed for the workshup lessons in the book. 
Delailed yet easy-to-follow steps to creating multimedia 
preserilafions, animation, and videos. Contains Ihe laiesl 
information on fillers, audio, superimposed clips, 
advanced editing, and more P\QM $44.95 

3-D Starter KH for Macintosh by Sean WagslafL 
Ihe complete reterence to 3-D graphics on the Macintosh 
- (deal (or beginning lo intermediate product designers, 
illustrators, graphic designers, multimedia developers, 
animators, and video produr^rs, as well as architects and 
engineers! Covers more than 50 major Macintosh 3-D 
imaging software packages - the most comprehensive 
book available Lots of idea-packed examples that 
Illustrate how 3-D pioduds work tedividuaEly and 
lugelher CD-ROM includes sample models, image 
galleries, backgrounds, and textures, plus 3 D software 
tryout versions $4406 $35 JO 

Net Char hy Michael Wolff & Co. There are an 
cstimaiGd 35 million people online and most of them spend 
time chatting on The Net. Net Chat is the first 
comprehensive, discriminating guide devoled lo Ihe vasl 
world ol online iulerperaonal cormnunicaiions. Following 
the successful formal ot the ever popular Net Guide, Nel 
Chal is designed lor easy access, featuring an attractive 
layout, informative illustrations, and thousands of choices. 
II is encyclopedic in scope covers "chat" groups on the 
IntcrncL all the major commercial services (including 
CompuServe, Prodigy, and America Online), and hundreds 
of bulidin boards, II features a map of salons and meeting 
places in Cyberspace, where people stop lo chat about 
poflltes, lifestyle, music, daling, sex, lanlasy, h^Slh, family, 
and jusi abou! everylhing imaginable! The entries include 
one- and Iwo-page spreils thal describe the Icalured topic, 
and provide easy-sccess inslrtctions. complete frstings, 
and visual images from Ihe Net. For use with all computer 
platforms PCs. Macs, workstalions, mm $17.90 

MORE Internet For Dummies"' by John Levine ^ 
Margaret Levine Young. The expanded guide lull o! great 
Internet lips for all those ims who want to know wtiere to 
go and whal to do ortce connected $ I QQ6 $17J5 

The Instant Internet Guide by Brent Mestop and 
David Angel I. An teternel jurnp-slart - hnw To access, use 
and navigate global networks, fhe Instant tnTemci Guide 
equips readers with the tools needed lo Iravei the electronic 
world, fhe book highlights the most rmpnrtanl sources of 
Internet news and information and explains how to access 
informalion on remote systems. II outlines hnw to use 
essential Internet ulililies and programs and fncludcs a 
primer on UNIX for fho Internet 224 pages mm $13.45 

The internet by Paul Hoffman gives the straight scoop 
on the Net with the elegant, entertaining 4-color 
companion to the PBS special "The Internet Show “ Color 
photos and Illustrations explain Internet key features, its 
history, and trivia. Covers tfie basics and also a multitude 
of Internet Information Services and extensive lists ol 
internet sites. $41-96 $22.59 

The Internet, Deluxe Editimi by Paul Hotlman All 
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of the bfilliancG of The Internet [ilus Ihe hoi NelManage 
Internet Chameleon soltwam! Tfiis bundled Deluxe Edition 
includes everything you need lo surf the Met! Fully 
aolomated, MetManage lias put togeHier 3 disks lilled with 
imernel tools, service pfoviders, applications, and more - 
anunbeljevablevalue! $34 99 $3L50 


The Internet For Macs For Dummies" by 

Charles Selter Now novice Mac users have an Internet 
guide written especiaJty for them - in the easy ...For 
Dummies™ style Ifieylove. SI7,95 

Tlie Internet For Dunimies" Znd Edition by 

John Levine and Carol Baroudi. Sort the net with ease 
using the up to the-minule new edition of the #1 
bestselling Internet reference - now with friendly help on 
connecting lo the Inter net. S I 0:0 9 $17.99 

The Internet For Dummies" Qirick 
Reterence by John Levine. This facl-lilled quick 
reference provides plain tnglisti explanations of Iriternct 
terms and basics. Cross-rulerenced lo "The Internet For 
Dummies" UM SS.OS 

The liiteritet For Macs For Dummies" 

Starter Kit by Charles Seiter. Access and navigate the 
Net like a pro the tun and easy way with this alLincfusivc 
Starter Kit for Man users. Ki! includes a special cdilton of 
the bestselling the Iniernel for Macs For Dummies", plus 
two disks tfiaturiny The Pipeline and TCP/Connect ir 
Extended sollware with: E-Matl, UscNct News Reader, 
Ftp. TelnsF Gopher, and more! $26.99 

Internet Power Tools by John Boss is designed for 
Inlermedtate PC users, Internet Power Tools is a complete 
bonk/disk pai;kage Etiat allows aco^ to the world’s largest 
network - the Inlernet - with tlie same case as one uses 
Windows. The detailed instmetions allow readers Eu find tfar 
way around the Internet fast and covers fr^il, file transfers, 
remote logon, on-ltne directories, and more The 
accompanying disk is packed with powerful utilities, 
including Celtn, PC Eudora, and Panda - easy-to-use 
graphical i^r intofte (GUI) lhal obviate the rxsed for fhe 
obsoire Unix line commands that everyone else must learn. 
It also provides access to even more software via RarKtom 
House s Inlemel FT? site and shows how to couned lo the 
Entertiel via a rtelwork connection or dial-in. $36.00 


The 1994 Internet White Pages by Seth Godin & 
James S. McBride is the one and only complete atphabetinal 
tlrreclory of people Oft the Internet $26.95 

Internet SECRETS by John Levine & Carol Baroudi 
gives the most Irom Ihe Mel with this performance 
oriented hook - for Windows, UNIX, DOS, and Mac 
Internet users wlio know how lo get connriclGd hut want to 
optimise their connections. $^9:99 $35*99 


FVifflT Weil Head; The Mac Guide to the 
UuU World Wide Web by Mary Jana Mara. 
Puhtisheri by PeachPil Press This is a beginning m 
intermEdiale book that shows you how to get Ihe most 
trem Ihe Web, using plain talk that beginners will 
understand, and online veterans will appreciate. Web 
Head also includes in-depth tours of the three leading 
Web browsers tor the Macintosh: Netscape. MaeWeb, and 
MacMosaic, and explains the basics behind all Web 
browsers so you will be ready ever^ when the next hot 
Web browser hits the scene. IE will also tell you how to get 
connected In ttie Web. finding your way across webspace. 
fine-tuning your Mac for top Web performance, and how 
to turn your Mac into a multimedia Web browser, t here is 
also instruction on how to build your own horue page, 
posting pages on the Web, and avoiding commort HTML 


mistakes $9496 $22,45 


The Underground Guide to Tele- 
cumuiuting by Woody Leonhard, Addison 


Wesley. There's no place like home. Especially when your 
boss, your kid. and the neighbor s dog are all barking for 
your attention simuhaneDusty. Working away Irom a 
corporate office presents great {ollen unexpected) 
challenges and offers even greater rewards Woody 
Leonhard lakes on the toughest aspects ol telecommuting 
and grves you the straight scoop on how to make it work 
lor you. Whether you're a tetecommuler, a telecommuter's 
bass, or just curious, The Underground Guide to 
Telecommuting will give you the tools and information 
you need to turn electricity and a phone line into major 
productivity $9496 $22,45. 


The Elements uf E-Mail Style by Brent Heslop 
anrl David Angell. Learn the rules of the road in the e-mail 
age. Cof)CEse, easy-to-i^ format explaining essential e- 
mail guidelines and rules It covers style, lone, 
lypuyraphy, formatting, politics and etiquette. II also 
outlines basic rules of composition within the speefai 
context of writing e-mail and includes samples and 
templates tor writing specific types ol e-matl 
correspondence. 208 pages $4696 $13,45 

E-Mail Essenltals by Ed Tittel & Margaret Robbins Is 
a hands on guide lo the basics of e-mail, the ubiquitous 
networks cnmmuriicatiori system The book is suitable for 
both the casual e-mailer and the networking professinnaL 
as it covers everything Erom Ihe Installation of e mail to fhe 
maintenance and management ol e mail hubs and 
message servers. The books explains the lundamental 
concepts and technologies ol electronic mall, le^turiug 
chapters un Lotus applications and CompuServe, as well 
as inlomeEion on upgrading, automation, message-based 
applications, and user training F-mail Essentials is a slep- 
by-step, jargon-lree guide that will eriable im e-mai! user 
to get the most out of the communication polenliats of 
iieEworking. 250 pp $9496 $22.45 


jnffTn The Cumputer Privacy Handtiook is 

UiiJM a practical guide to e-maiJ encryption, data 
protection, and PGP privacy soUware. With millions of e- 
maif messages and on-line etiscussions exchanged daily 
on the Internet, electronic security has become a key 
concern The Computer Privacy Handbook explains 
practical steps individuals can lake to safeguard tbeir 
cli^tronlc security. It also gives a vivid description ot 
how the “Surveillance Age'' threatens each person's 
personal s®:urily, a non-lechnical introduction into data 
encryption, and the U.S Government's Clipper Chip 
surveillance proposal It also provides an overview ot 
PGP, [Pretty Good Privacy), the world standard for e-mail 
privacy. $9496 $22.45. 


America Dniiiie Far Dummies" by John Kaufeld, 
“Driver's Education" tor this wildly popular on-tine service - 
covering everything from the niain menu lo the mail groups 
for Windows, DOS. and Mac platforms, Incluctes a coupon tor 
free usage time on AOL for firsHrrne users. $W:99 $17.95 


CompuServe For Dummies" by Wallace Wang. 
Find out how lo shop, play games, join forums, gel Ihe 
latest news, do research, and more on this popular on- 
lineservice. W9& $17J5 


eWorid: The Offieial Guide for Maemtosh 
Users by Cary Lu & .lotiri Milligan. Discover the r>ext 
generation ot online services - Apple's eWorld. Certain to 
be a bcstseiler, this aultiorized guide lo contains the 
exclusive Apple software needed to comect to eWorld If 
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also provides a road map of eWorld and ail of its features, 
and is the first and best book on this exciting new service. 
Covers every aspect of eWorld, the next getieralion ol 
online services Every thing users need to gel connected 
and gel Itie most out of eWorld Ihe only official Apple 
hook and software tor accessing eWorld $9996 $26.95 


NEW! 


PowerPC System Architecture by 

MindShare This hook describes the hardware 


archlteclurs ol PowerPC systems, providing a clear, 
concise explanation ol the PowerPC specification, the 
template upon which all PowerPC processors are 
designed. The aulhor provides a compleie description of 
the specification for both the 32- and 64-bit 
implemenlalions. 656 pages $A4fl6 $31,46 


imni PCI System Architecture, Third 
Edition by MindShare, Describing reyision 
21 of the Peripheral Componenl liiterconnecE (PCI) bus 
specilicalion, this book explores PCLs relalionship lo the 
rest ol Ihe system If includes an in-depth trealmeni of 
PCI lu PCI bridges, ihe PCI BIOS, the 66 MH 2 PCI bus, 
and more. 592 pages $9496 $31*46 


ffinn Cyberpunk Handhookf The Real 
miJM Cyberpunk Fakehook by St. Jude, 
R.U.Sinus, and Bart Nagel. Published by Random House 
This book lells fiuw lo tell if y&u or somone you know is 
aCyheqjunk. $^96 $8.95 


THE APPLE UBILUIV 


Q Advanced Color Imaging On the Mac 


0 $ explains how you mi augrnetil the color 
support supplied with Quickdraw, and QuickdrawGX. 
using Ihe Palelte manager to provide Ihe best set td colors 
nn displays with limiled color capabilities, soliclliiig the 
color choices Irom users with Ihe color Picker Manager/ 
Using the ColorSync manager lo match colors between 
screens and input and output devices such as scanners 
and printers/ learning how Ihe color Manager assists 
Color QuickDraw in mapping an applications color 
requ^ts to the actual colors available. $39^96 $33,25. 

3D Graphics Programming Using 

QuickDraw 3D by Apple Computer, Inc, 
Now you can mcorporale speLlacular 3D graphics into 
your applications This book/CO-ROM package explores 
QuickDraw 3D, a graphics exlensinn to ll^e Mac OS lor 
Power Macinloshes The CO conlains the complete 
QuickDraw 30 system itself and a complete database of 
the QuickDraw 30 API, allowing you instant access to Ihe 
hundreds ol graphics calls via a fast viewing engine. 
Book/CD RDM. 640 pages. $99* $35.96 

piyjlj Apple Guide Complete by Apple 
““ Computer, Inc. For those who want the full 
power of Apple's complete loolset, this book and CD- 
ROM package from Apple provides ^eryihing you need lo 
produra guide files surx'.SBslully. includlnQ Guide Maker, 
Ihe software you use to build and iesl guide Hies. You'll 
learn about the complete cycle ot designing as well as 
advanced topics such as scripting and coding guide files. 
Bnok/CD-ROM, 544 pages. $99* $35*96 

Inside AppleTalk by Gursharan S, Sidliu, Richard F 
Andrews and Alan B Oppenheimer. Apple Conipuler. Inc 
65G pages. $9496 $31,45 

AppleScript Finder Guide, Engfisft DWeet by Apple 
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Computer, Inc. $17.95. 

AppleScript Language Guide, by Apple 

ComputerJnc. $26.95. 

AppleScript Scripting Additions Ikddejby 

Apple Coopjter. Inc. $4^ $17.06. 

HyperCard Stack Design Guidelines by Apple 
Computer, Inc. is an essential book for everyone who 
creates Apple HyperCard slacks, from beginners to 
commercial developers, tl covers the basic principles of 
design that, when incorporated, make HyperCard stacks 
effective and usable. Topics include guidelines, 
navigation, graphic design arrd screen illustration, text in 
stacks, music and sound, a sample stack development 
scenario, coliaborative development, and the Stack 
Design Checklist. 240 pages $19.95 

Macintosh Programmer’s Toolbox Assistant 
CD-ROM - Instant etectronic access to Inside Macintosh 
essentials. Now Macintosh programmers can get quick 
access to over 4,000 Toolbox calls Ihal are at the heart of 
Macintosh system software. The definitiorrs of these data 
structures, resources, constants, and tunctions are 
documented in Ihe Inside Macintosh scries and are 
essential information lur anyone developing Macintosh 
software Macintosh Programmer’s Ttxjltwx Assistant is a 
CD-ROM that harnesses the power of one o1 the best 
search and viewing engines in the industry ll allows 
programmers to acce^ Ihe Toolbox calls quickly from their 
developmenl environment. With iiypertext links allowing 
praqramnters to view related topics easily. Macintosh 
Programmer's Toolbox Assistant is IIk! ultimate electronic 
reference tool for Macirrtosh programmers, $99.95 

Inside Macintosh^: CD-ROM by Apple Computer, 
Inc. Inside Macintosh is the essential reference for 
programmers, designers, and engineers lor creating 
applicaliorts for the Macinlosh family of computers. Inside 
Macintosh CD-ROM collects more than 25 volumes in 
Diecifonic form, including: QuickDraw" GX Library. 
Macintosh Human Intertace Guidelines. PowerPC System 
Software, Macintosh Toolbox Essentials and More 
Macintosh Toolbox. QuickTime and QuickTime 
Components Mow programmers will be able to access over 
16,000 pages of the information they need directly from their 
computers. Hypertext tinki'ng and extensive aoss relerencing 
aaoss volwries allows programmers to search and explore 
this library In ways that are uniqiKi 10 the electronic medium. 
Every Macintosh programmer will regard Inside Macintosh 
CD-ROM as Itieir most important resource. $99.95 

Inside Macintosh^: Overview by Apple Computer. 
Inc. is the first book that people wlio are unfamiliar with 
Macintosh programming should read, it gives an overview 
ol Macintosh programming fundamentals and a road map 
Id Ihe New Inside Macintosh library inside Macintosh: 
Overview also covers various programming loots and 
languages, compatibility guidelines and an overview oi 
considerations lor worldwide development. 1 ?G pages. 
$ 20.55 

Inside Macintosh'^: Files by Apple Computer. Inc 
describes Ihe parts of the operating syslem that allow you 
to manage files It shows how your application can handle 
the commands typically found in a File menu It also 
provides a reference to Ihe File and Alias Managers, the 
Disk lniffalf?alior and Standard File Packages. 510 pgs. 
$26.95 

Inside Macintosfi^: Operating System 


Utilities by Apple Computer, fnc. describes parts ot the 
Macintosh Operating System that allow you to manage 
various low-level aspects of the operating system. Everyorte 
who programs the Macintosh should read this book! It will 
show you in detail how to yal inlormation about the 
operaling system, manage operating syslem queues, handfe 
dates and limes, control the settings ot the parameter RAM. 
manipulate lf>B bap dispafeh table, am) receive and respond 
to low-levef system errors. $2^ $23.45 

Inside Macintosh*: Processes by Apple 
Computer, Inc. describes the parts ot the Macintosh 
operating syslem that allow you to control the execution 
of processes and interrupt tasks. II shows in detail how 
you can use the Process Manager to get fntormation 
abnul processes loaded in memory. II Is also a reference 
lor Ihe Vertical Retrace, Time, Notification, Deferred Task, 
and Shutdown Managers. 208 pages. aij2 0b $20.65 

Inside Macintc^^: Memory by Apple Computer, 
Inc, describes the parts of the Macintosh operating 
system that allow you to manage memory It provides 
detailed strategies for allocating and releasing memory, 
avoiding low-memory silualions. relerence to the Memory 
Manager, the Virtual Memory Manager, and memory- 
relaledurillties. 296 pages. $22.45 

Inside Maerntnsh^; AOCE Appiication 
Interfaces by Apple Compuler. Inc. shows how your 
application can take advantage ol Ihe system software 
tealures provided by PowerTalk system software and the 
RowefSJtrre collaborahon servers, Nearly every Macinlosh 
application program can benefit from the addition of some 
of these features. This book shows how you can add 
electronic mail capabilities to your application, write a 
nifissaging fipplication or agent, store informal ion in and 
fehieve information from PowerShare and other AOCE 
catalogs, add catalog browsing and find-in-catalog 
capabilities to your appiicaiion. wrile templates that extend 
the finder's ability to display information in PowerShare 
and other AOCE catalogs, add digital signatures to files or 
to any portion of a document, and establish an 
aulheiiElcaled messaging connection. $404§ $35.40 

Inside Maemtesh*': AOCE Service Access 
Modules by Apple Computer, Inc. describes how to wrile 
a sollware module that gives users and PowerTaik-eriabfed 
applicaljons access to a new or existing mail and 
messagirrg service or catalog service This book shows 
how to wrile a catalog service access module (CSAM), a 
messaging service arxess module (MSAM). and AOCE 
templates that allow a user to set up a CSAM or MSAM and 
add addresses to mail and m^sages. $ 2606 $24.25 

Inside Macintosli^: Devices by Apple Computer, 
fnc. dfiscrihes how to write software that interacts with 
built-in and peripheral hardware devices. With this book, 
you'll learn how to wrile and install your own device 
drivers, desk accessaries, and Chooser extensions; 
communicate with device drivers using the Device 
Manager, access expansion cards using lire Sfol Manager, 
control SCSI devices using SCSI Manager 4.3 or the 
original SCSI Manager; communicate directly with Apple 
Desktop Bus devices; interact with the Power Manager In 
battery powered Macintosh computers; and communicate 
with serial devices using the Serial Driver, $2^96 $26 J5 

inside Maciittiisti*: Macintosh Toaibiix 
Essentials by Apple Computer. Inc covers the heart ol 
the Macintosh, The toolbox enables programmers to 
create applications consistent with the Macintosh "look 
and feer. This book describes Toolbox routines and 
shows how to implement essential user interface 


elements, such as menus, windows, scroll bars, icons and 
dialog boxes 880 pages $^446 $31.45 

litside Macintosh^; More Macintosh Toolbox 

by Apple Computer, Inc. covers other Macintosh features 
such as how to sut^ort copy and pa.ste, provide Balloon 
Help, play and record sound and create control panels are 
covered in this volume, The managers discussed include 
Help, List, Resource, Scrap and Sound $^46§ $31.45 

Inside Macintosh": Networking by Apple 
Computer. Ir>c describes how to write software tbai uses 
AppleTalk networking protocols. It describes the 
components and organization of AppleTalk and how to 
select an AppleTalk prolocol. II provides the complete 
application interfaces to all AppleTalk protocols. Including 
ATP (AppleTalk Transaction Prolocol). ODP (Dalagram 
Delivery Protocol), and ADSP [AppleTalk Data Stream 
Protocol), among others $ 29 66 $26.95 

Inside Masintoslt^; Interapplication Com- 
municatien by Apple Computer, Inc. shows how 
applications can work togetfier. How your application can 
share data, request inlormation or services, allow the user 
to automate tasks, communirate with remote databases. 
mM $31.45 

inside Macintesii^: PowerPC Numerics by 

Apple Computer. Irrc. describes lire linaling-point numerics 
environment provided with the first release ol PowerPC 
processor-based Macintosh computers. The numerics 
environment oonforrrts to the IEEE standard ?54 tor binary 
lloating-puint arithmetic TTms book provides a description 
of that standard aiKl shows how RISC Numerics compiles 
with it This book also sliows programmers how to create 
lloating-poinl values and how to perform operations on 
tioaling point values in high-level languages such as C and 
in PowerPC assembly language 4 2 6 96 $26.00 

inside Macintosh^: PowerPC System 
Software by Apple Computer. Inc. describes tbe new 
process execution environment and system software 
services provided with Ihe first version of Ihe syslem 
software for Macinlosh on PowerPC computers. It 
contains information you need to know [o write 
applicalions and other software that can run orr the 
PowerPC. PowerPC System Soltware shows in detail how 
to make your sollware compafible with Ihe new run-time 
environment provided on PowerPC-based Macintosh 
computers II also provides a complete lectuiical reference 
tor Ihe Mixed Mode Manager. Ibe Code Fragment 
Manager,and Ifie Exceplion Manager. $24-66 $22.45 

Insiife Macintosli^: Sound by Apple Camputer. 
Inn. describes the parts of the Macinlosh system sotlware 
iTial allow you to manage sounds, it contains Information 
Ihdl you nGod to know to write applications and other 
sotlware ttial can record and play back sounds, compress 
and expand audio data, convert text to speech, and 
perform other similar operations. $26:66 $24.25 

litside Macintosti^: Text by Apple Compuler. Inc. 
describes bow to perform text handling, from simple 
character display to mull i-long trage processing. The Font, 
Script. Text Services, and Dicbonary Managers arc all 
covered, in addition to QuickDraw text. TextEdit, and 
International and Keyboard Resources. MM $35.95 

Inside Macintosh^: Imaging by Apple Computer, 
Inc. covers QuickDraw and Color QuickDraw. The book 
includes general discussions ol drawing and wr^rking with 
color. It describes the structures lhal hold images and 
image Intermahon, and tie routine that manipulate them. 
It also covers the Palette, Color, and Printing Managers, 
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and the Color Picto, Color Matching, and Picture 
litiHties. $24,25 

Inside Macintosh'': QuickDraw*' GX Graphics 

by Af^le Computfif, Inc. ^ows readers how to create and 
manipulate the fundamental geometric shapes of QuickDraw 
GX to generate a vast range of graphic entities. It also 
demonstrates how to work with bitmaps and p\(Xum. and 
spccialiifcd QuickDraw GX graphic shapes $24*25 

Inside MacintosliQiiictcDraw" GK Ohjects by 

Apple Computer. Inc. introduces QuickDraw GX and its 
abject structure, and shows programmers how to manipulate 
objects in all ty|]es of programs. $24*25 

Inside Macintosh^: QuickDraw" GX 
Enviroument and Utrlities - A compariiori to 
QuickDraw^ GX Objects, this book contains programming 
infofmation useful to any deveioper writing QuickDraw GX 
applications It describes OurckOraw GX memory 
management, error handling, debugging, and 
mathematical functions, as well as conversion from 
OtiickOraw to QuickDraw GX $ 3Q 05 $25.95 

Inside Macintosh*^: QuickDraw" GX Library 

by Apple Computer, Inc is the powerful new graphics 
architecture for the Macintosh Far more thari just a 
revision nt QuickDraw, QuickDraw GX is a unified 
approach to graphics and typography that gives 
pruyrammers unprecedented flexibiiify and power in 
drawing and prinlirig alt kinds of sitapes, images, and text. 

Inside Macintosh^: QuickDraw" GX Printing 

This book is essential for any deveioper wtirse QuickDraw" 
GX application supports printing. If shows how to support 
the new printing teaEures of QuickDraw GX, including 
desklop priniers and expandable priming dialog boxes. 
QuickDraw GX Printing also shows how lu use prinliny- 
reialed objects to add custom panels to printing dialog 
boxes and to create custom page formals. $24.25 

Inside Macintosli''; QuickDraw "GX Printing 
Extensions and Drivers - Any developer who wants 
to create extensions to the application printing capabilities 
of QuickDraw* GX, or who needs to write a printing device 
driver that works with QuickDraw GX needs this book 
QuickDraw GX Printing extensions and Drivers describes 
hnw to create printing extensions and printer drivers, and 
provides a complete reterenrxj to the messages, functions, 
and resources that limy use. $26.95 

Inside Maclntosli^: QuickDraw" GX 
Programmer's Overview This book provide an 
[ntrodiiction to QuickDraw^ GX, providing an overview of 
the QuickDraw GX environment from a devetoper's 
perspective, it introduces the QuickDraw'^ GX 
prograrnmirig and runtime environments, the relationship 
between QuickDraw GX and the rest of itie Macintosh® 
systems software and toe relationship between QuickDraw 
GX and Macir^tosh applications. The key elements of 
QuickDraw GX programming, data structures, object 
types, and functions used most frequentty by QuickDraw 
GX developers are also covered After a general 
introduction, this booh provirJos readers with a series of 
practical examples demonstraling how to approach 
programming with OuECkDrawGX $22.45 

Inside Macintosh*; QuickDraw" GX 

Typography - This book is essenlial for any developer 
who uses QuickDraw* GX to manlpiilafe text II shows 
how \o use QuickDraw GX objects to tiandle all hinds of 
text - Irom plain, unstyled text lo complex, mixed- 
direclion and multi-language text with sophisticated 
stylistic and typographic variations. QuickDraw GX 


Typography shows how lo create and manipulate the three 
different types of text shapes supported by QuickDraw GX 
irtetuding text shapes, glyph shapes, and layoui shapes. 

mM $ 26.95 

Inside Macintosh'^: QiiickTime by Apple Computer, 
Inc, Is for anyone who wants to create applic^ions that use 
QuickTime, the system software that allows the integration of 
video, animation, and sounds into applrcations. This book 
desaibesail of the QuickTime Toolbox ufilines. In addition, it 
provides the Information you need lo compress and 
decompress imagesand Image sequences S;7D.06 $26.95 

inside Maciutosh'^: QuickTime Components 

by Apple Computer, Inc .covers how to use artd develop 
QuickTime components such as image cornpressurs. uiovie 
contfollers, sequence grabbers, and video digilizers. $S44J& 

$ 31*45 

Inside Macintosh^': X'Ref by Apple Computer, Inc, is 
a fast access to all the information in Inside Macintosh 
Inside Macintosh X Ref; Provides programmers with a quick 
and easy way to find the exact information they need in this 
ddlnitive suite of books, (all 26 volumrs), It Is indexed by 
topic, volume, chapter, aod accompanying page number, 
mM $17.95* 

Inside the Macintosh Communications 
TuolBox by Apple Computef This buck is Itie dellnilive 
reference to the Maclnlosh Communications Toolbox* an 
Integral part of the System I Maciiilosti Too [box thal enables 
developers to create communications applications or add 
communications features to other applicalionsJhis book 
describes all of the routirtes toat provide programmers with 
standard m:ess to important Gommunicallons services and 
in addition enables programmers to extend the reach of the 
Macintosh into non-Apple environments. $22.45. 


i-nmiRS 



BBEdita.l Irom Bare Bones Sotlvirare is nuw belter Ilian 
I ever. In addltlan lo being Acceleraied tor 
Power Macintosh, this powerlul, intuitive text 
pdilof offers integraled support for THINK C 
tj 0, Metrowerks CodeWarrior 6, THINK 
Reference 2.0 aid MPW ToolServer. Version 3.1 adds even 
more capability, including "soft" wrapping ol text on screen 
and numerous refinements and improvements lo the user 
Interface BBEdiFs many features inefude: Integrated 
PopupFuncs** technology for speedy navlgatfon of source 
code files (C, C++, Pascal, Rez, 68K Assembler, and 
Fortran), unique find Differences' command [BSEdit can 
find differences between projects and folders as well as 
files), support for Macintosh Drag and Drop for editing and 
other common tasks, PowerTalk support for reading, 
sending and composition of PowerTalk mail, scripting via 
any OSA compatible scripting language including 
AppleScript and Frontier 3.0, and last search and replace 
with optional 'grep" matching and multi-file searching. 
RBFdirs robust feature set and proven performance and 
reliability make it fhe editor of choice for professionals and 
hobbyists alike $99 


CMastef 2.0 by Jersey Sderrlillc irtstells into THINK C 5 
/ 6 / 7 and Symantec C++ lor Macintosh, aid enhances the 
editor. Use Its lunclion popup to seleci a function and 
CMaster takes you figfil to it Ottier leatures indude muitiple 
clipboards and markers, a Funclion Prololyper, and a 
GoBack Menu which can lake you back to previous editing 
contexts Almo^ all features bindable to tite keyboard, atong 
over a hundred keyboard-only features like "Add New 
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Aulomafic Variable “ Glossaries, AppleScript and ToolServef 
support. Maaos, and External Tools you create too! $129,95 

QUED/M 2.7 by Nisus Software, Is a programmer's text 
editor which has ddined the Industry standard for speed and 
efficiency With intogralcd support for Synrrantec C/C+4, 
Metrowerks CodeWarrior 6, and MPW. QUED/M offers 
imrivalfid usetotnoss for the Macintosh developer. In addition 
to supporting all the major developrDent environnyents on toe 
Macintosh. QUED/M offers dozens of powerful edifing 
features, Including unlimited undo and redo, UNIX style 
GREP searching, macro language, scripting, text folding, text 
sortirvg, file comparison and merging, Toolbox lookup, ten 
eclilable/appendabio clipboards, line numbering, markers, 
displaying text as ASCII codes, vertical and horizontal screen 
splitting, plus much more. $149 


DEVEtOPMl'Nl' I-NVIKOJVMFMIS .\1VI> 
LANGUAGES 


GodeWarnor 7 CD by Metrowerks 
corT>es in two versions Bronze end Gold, 
JIQA These CDs contain the CodeWerrior 6 
M m \ devctopfTrcrrt envlronmcol including C++, C 
uir i irgfliiFi and Pascal compilers, high-speed linkers; 
native-mode Interactive debuggers; and a powerful new 
application Iramework called PowerPlant for rapid 
Macintosh development in C++ Bronze generates 680x0 
code. Gold generates both 680x0 and PowerPC code. All 
versions are a 3 CD subscription over a f year period. 
Bronze: $149,Gold: $399. Bronze comes with a 6- 
month MacTech subscription. Gold comes with a 
1-year subscriplian. Both at no additional charge! 


SYMANTEC 


Symantec C++ for Macintosh is an objecl 
oriented development environment designed for 
pfolessional Macintosh programmers. Syroanlec C++ 
leatures powerlul Dbiecl-oriemed development tools 
wilhin a comptelely integrated envlronmenl. The C++ 
compiler, incremental linker. IHINK Class Library, code 
editor with coloring, integrated browser, debugger wllh 
slack crawl and autumafic project management give 
Symantec C++ fast lurraround times. This pmduci 
compiles tor both PowerPC and 65K machines. Symantec 
C++ supporls mulllpfe editors and translators, so you can 
use your lavorila toois and resource editors as well as 
scripts you've written within I he environment And with 
foolServer, you'll Ie able to customize menus and attach 
scripts based on Apple evenls, AppleScript, and MPW 
Tools, fhe byitlHfi SourceServef provides a source code 
control system, allowing teams ol programmers lo solve 
tough probterus lasler. With SourceServer, you'il always 
know youTe working on the latest version. And you1l have 
old versions al your fingertips when code "breaks" and 
you need to look back al modifications, $369 

THIMIC C by Symantec Corporation THINK G is easy lo 
use and highly visual, making if the No 1 selling 
Macintosh programming environmenl. Enhancements 
make this product lasler and more versatile than ever, 
improving your productivity wtth more powerful project 
management, a full set of tools, and script support for 
major script based languages. With the THINK 
environment, you spend less time on routine 
programming tasks due to an extremely fast compiler and 
incremental linker. In addition, the automatic project 


NoVHMH+’K 199"^ • IVlACfri'CllMACiAZJNl: 


Ma([, OiUJFu Srom 


75 
















MAIL ORDER STORE 


inaTtager saviss you tjirie by Irackrng changes to your fiEes 
and recompiling only those that have changes. All the 
tools you need - a mulli-window editor, compiler, linker, 
debugger, browser, and resource cdilor are completely 
integrated lor speed and case o1 use One cil the most 
valuable of these tools is the THINK Class Library, a sel of 
program building blocks lhal gives you a head start in 
writing obj eel-or ten ted appbcalions. And with the new 
open architecture, you can use your favorite tools, 
resource editors, and scripts within the environment. 
THINK C is the logical next step lor programmers who 
have worked in HyperCard or other script-based 
development environments. The environmcni supports 
AppleScript Apple events, and Frontier, so you can link 
and auiomate complex, muili-prnject operations. Prodiicl 
Contents; Four Macintosh disks, an B32-page user 
marnisl, and a 568-page IHINK Class Library Guide. 
$219 

THINK Pascal w, 4.0 by Symantec Corporation. 
Professionals and sludents will welcome this version of 
THINK Pascal. It is fully integrated tor rapid tiimaround 
time and lets you lake advantage at System 7 capabilities. 
Features include support lor targe projects, enhanced 
IHINK Class Library, System J com pat ibi lily, superior 
code geueratiou, atid smart linking. Producl ContanlS’ 
Four Macintosh disks, a 562-paoe user manual, and a 
498-paye ubjed-orienled programming manual. $ 169 

1$ Object Pascal CD Includes the world's first 
Object Pascal compiler tor Power Macintosh. 100% 
compalihle with Apple's Ml^ Pascal, L3 Objed Pascal 
combines I he best ot Apple's nalive development tools 
wilh innovative new lechnology developed at Language 
Systems CompileT options specify 63K or native 
PowerPC code generaiion. Included on the CD are: LS 
Object Pascal compiler, Universal Pascal Toolbox 
interlaces, fully loaded MPW 3.3.1, 68K and PowerPC 
source debuggers, PowerPC assembler, online 
documentation. Macintosh Tech Notes, and a special 
version of AppMaker hy Bowers Development that 
generates native Pascal source code. The beta release 
includes upgrades lo vl.O wfieu it becomes available. 
$399 


IPA MacProlog comprises a Ldinburgb syntax 
Prolog carTvpilcr system set in an allradive multi-window 
development environment wilh an irilegraled program 
edilt]?, graphicai caiFgtapli ladhlies and an interactive 
source-level debugger, LPA MaeProtog features high- 
level access to the Macintosh ToolBox for using graphics, 
dialogs, windows, icons, resources in a simple arid 
versatile way LPA MacProlog also Includes interfaces to C 
and Pascal code resources. The MacProlog Run lime 
Generator enables the production of double-clickable 
dislribLiiable applications The compact run-time system 
supports lifst argument indexing, tail-recursian and last- 
call optimi7atiorr. Optional add-ons toots include itex, 
Prolog++. MacDBI for Oracle and Ihe MacProlog Dialog 
Edilor. Programmer Edilion $/45 Developer Edition 
(which includes Ihe run-lime ger^erator and distribution 
license) $1600 



i-s 


SmalftalkAgents" a 

superset of the Smalltalk 
larvguaye, is fully 
inlegrated with Macintosh, 
incor-porating design 
features specilically lor the RISC and Macinto^ System 7 
archileclure. SmalltalkAgents is a true object oriented 


workbench tbai includes an incremental and extensible 
cornpilBL an array of design and cross reference tools, 
preemptive interrupt driven threads and events, an 
extensive class library including classes for general 
programming, classes for the Macintosh user interface 
and classes lor the Macintosh operating system 
Integration of components In enterprise systems is 
simplified with tbe network, telecommunication, and intcr- 
application communication libraries, The SmalltalkAgents' 
extensive class library and add-on components make it 
especially well suited as a development workbench for 
custom applications in business, education, sefenen, 
engineering, and academic research, $695 
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MacDesigner/Expert by Excel Software supporfs 
sollware engineering methods with the capabilities ot 
MacDesigner plus multi-task design, An Integrated 
requirement database provides trace^ility from requirement 
statements to design diagrams, code or test procedures. 
This tool is wetl suited to design or maintenance of real¬ 
time, multi-tasking software projects, Demo $79. Product 
$1595 MacDesigner Demo $79. Product $9^ 

MacA&D by Excel Software r^mbines Ihe capabilities ol 
MacAnalysl/Experl and MacOesigner/fcxperl inlo a single 
application W supports structured analysis and design, 
objoct oriented analysis and design, real-time exiensions. 
task design, data mndelrng, screen prdotypiny, code editing 
and hmwsing, reemjineering, requiremenl Iraceahilily, and a 
global data dichonary. Demo $149. Producl $2996 

MacAnalyst/Expert, Demo $79, Product $1595 
MacAfialyst Demo $79. Product $895 MacDesigner/ 
Expert, Demo $79, Product S1595 MacDesigner 

Demo $79, Product $996 By Excel Software. Available, Call 
for more information about these products. 

Voodoo is a version control tool for the simple and 
Clear managemeni of proiocts in which files are aealed in 
numerous versions (variants and revisions). Voodoo 
allows both variant and revision control, and it mintages 
r^at only varianls anrl revisions of single Hies, but ol a 
whole software project (multi tiles, rnulli users, mulli 
variants, access riglils, ...). Hie lool oflers a neat 
graphical user interface and is not only suilable lor mere 
source code mntroJ bul can hartdle all differenl kinds ol 
tries with amazing compression rales: typical z\m of delta 
between arbitrary files 5% (in words: five per cent) INI no 
matter whether the files are plain lexi or any other 
docurnenls -e.g., MSWord, 4D, Canvas. FifeMaker ., 
Please nole special prices for multiple 
copies: single license $190; 2 pack 
$300; 5 pack $655; 10 pack $1140; 20 
pack $2000 Add ! pricing available on 
reguesl 


PROFILERS / iTHBlICiGERS 


U Profiler by Lars Jordebo Datakonsult supports 
pfotillng ol C++ 68K and PowerPC applications compiled 
wilh CodeWarrior 6. CFront or Syrtranlec C++ Based on 
active protJling, ie, proliling code called at lundion enler 
and exit, the browser application lets you lollow call chain 
timings in hierarctiical vtews or separate windows 
Colled, organize, compare and save profiling data from 
dillerenl versions ol your application inlo a project 
Scriplable and recordable with full access to most internal 


data sfryclures Optional remote proliling and tracking of 
segmsnl and stack usage Full source a)de lo what you 
link info your application $295 

Last Resort Programmer's Editiiin records 
every keysiroke, command key and mouse event (in local 
coordinates) to a file on your hard disk. This is especially 
uselul lor program testing St debugging, and lor technical 
suppurl and help desks. II something goes wrong 
(Ixjcause of a power lailure. system crash, lorgetting to 
save or deleliny lines) and you lose a word, phrase, or 
documeni you can look in Ihe Last Resort keystroke file 
and recover what you typed. Lasl Resort Is also uselul lor 
technical support personnel, wiren they have lo ask “What 
was the last Itiliig you did belore...?" $74,95 

The Memory Mine™ by Adianta is a stand alone 
debugging tool lor Macintosh and nalive PowerPC. 
Programmers can monitor heaps, identify problems such 
as memory leaks, and stress test applicatiorrs. Active 
status of memory in a heap is sampled on the fly: 
allocation in non-relocatable (Plr), relocatable (Handle) 
and free space is shown, as are heap corruption, 
tragrTrenlalion, and more.,. Allocate, Pur^, Compact, and 
Zap memory let users stress test all or part of a program 
Source code is not needed to vrew heaps. It works on 
Macintoshes wilh 68020 or later and System 7 0 or later 
$99 

(J0™ by Onyx Technology, Is a system extension lhal 
stress tests code during runlime for carnmnn and not-so- 
commoti errors. Tests inclndfi heap checks, purges, 
scrambles, handle/poinier validatinn. dispose/release 
checks, write to zero, de reterenee zero as well as other 
tests like free memory invalirialion and block bounds 
checking. DC is extremely user Iriendiy far the non¬ 
technical tester yet offers an API for programmers who 
want precise control over testing DC is Also available in 
Japanese $99.95 

Spyer by tnCider is a simple operated lool lhat records 
all actitiris {including mouse movemenl) you perlofm on a 
Macintosh computer and then replays them al your 
preferred speed. The recortfed data can be saved in files 
lor luLure use. Spyer works as a background process with 
any Maiinlosh applicaliuri and is triggered by user 
detined Hoi Keys. Spyer enables Itie “Continuous Redo" 
utility and Is especially uselul lor sollware tesling and 
demanstralion. $39 


INSTALLER TOOLS 


litstallerPack " by Stepllp Software is a package of 
several Installer "atoms" lhal lei developers incorporate 
graphics, sounds, lite cornpressiori and cuslom lolder 
icons into Installation scripis. Cumpressiuri formats 
supported are ('.nmpaef Pro k Diamond, Each alom also 
3 va I fable sepa ra te l y C n mpr ess to n req u i res add i lion a I 
licensing. 1219 

ScrIptGen Pro™ by SiepUp Software is an Installer 
script generalor which requires no programming or 
knowledge ol Rez. Supports StepUp’s InstallerPack, Stuftit 
compression, cuslom packages, splash screens, network 
inslalfs, Rez code output, imporling resources, and 
AppleEvenl link w/MPW: $169 


UBRARmS 


3D Game Mactiine v1.2 by Viriudlly Unlimited 
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is a C library for Greeting lightning fas^ 3D arcaiJe games 
and interactive ninltimedia applications. 3DGIVI has a 
simple easy-to-use interlace and features very fast 
rendering (15 frames per second on a 14" monitor 
completely texture-mapped, with a PowerMac 61CH1/60), 
full "virtual" 3D worlds with six degrees ot Ireedom, Iree- 
form texlore mapping, shading, materiaf and Nghl 
properties, convex/cave polygons with unlimited vertices, 
unlimited light sources, dynanric hidden surface removal, 
special graphic modes lor fasi luii-screen animation, 
collision defection, explosion simulation. 3D riaia 
importing. Runs on all Macs? Works with CodeWairior 
$299 ^ license, 


Animation Class Library version 2.0 (AGL2 0) 
is an advanced obiccl-oriented mullimadia iramewnrk, 
allowing fast development of high-quality interactive 
applications. Main features ot ACL2.0 are: Powerlul 
animation engine winch supports structured sprites, 
collision detection at pixel precisian, sprites sorting, 
powerlul hlittcr and vector objecis. Scrnlling ot 
background picture in circular bufier and tite- 
mapscroiling. Application framework for building 
standard and 3D controls, panes,menus, futi screen 
displays, windows, elc. Quickfime and multi-channet 
sound supporl. >800 lunctions and >100^000 lines. 
Compfele C++ source code lor CodeWarrinr and 
Symantec C++, examples, documentalion and lechnical 
supporl, $250 


dtF is a true relational dalabase system for Apple 
Macintosh computers. dtF provides a poweriut choice tor 
developers who want to create database centered 
applications with no pert[)rmancc trade-offs. dIF features 
SQL. full transaction corthol. error recovery, single user, 
client server architecture and mullhplatform support 
including DOS, Windows. OS/2 arte UMIX, Ihe C/G++ API 
is identical and fully portable cross all supported 
platforms. Third-party vendors supporting dtF will be able 
to offer a vartely of advanced features and benefits to their 
customers royal^ tree. Tools are fncliiricd for importing, 
exporting, creating and managing databases and users. 
Supported development environments include; Symanteo. 
MPW, Melrowerks and more. Mac/SOK $69b 


MaeWireFrame by Amplified 
Inteillgance. Create your own virtual reality 
appfication with MaeWireFrame. a virtual 
reality application frame work. Includes a 
complete library of object oriented graphics routines, its 
own easy to understand application Irame work (similar to 
MacApp nr TCL but a lot easier to understand), plus an 
exampfe application program that lets you slarl sotid 
modeling righl away Comes complete with fully 
documented source code. All new purchases wilt be 
guaranteed a $49.99 upgrade to Ihe soon to be released, 
scriptahle. MaeWireFrame 5.0. Due to the overwhelming 
response the special price offer has been extended lor a 
lillte while longer Special Offer: $7S!ni 


FictureCDEF 1 .S by Paradigm 
Software is a professional-levet CDEF 
for cfeatjrrg custom graptiical buttons 
(8-64 pixets). PictureCDEF is used in products by Adobe, 
ProVue, STF Technologies and others. It is multi-monitor 
and bit-depth sensitive. The buttan graphic (cicn, ResEdit) 
can he changed at runtime and even animated with a call¬ 
back roultne. Create distinct botlons in seven variations: 
MultlStale, PushBijItor!, FtexiBulton. ToggleButton, 
ChkButlon, PushPicISutton and ToggIcPietfiutton Position 
the optional button liile at iefl, bottom or right, or follow the 
system text direction for inlernalioital support. Manual, 



sample code and MacApp 3.0 support included, Full source 
ctxfe; $a5,00 Object codo: $45.00. 

Q3S/3ilPaiie/$inartPane source code bundle by 
Vivislar Consulting Q3S: source code bundle from 
ViviSlar Consulting. Full featured 3d graphics. Points; 
lines, polygons; polyhedra; Gauraud shartlng; 7-huffering; 
culling; depth cueing; parallel, perspective, and 
stereoscopic projections; performance enhancing 
"OnlyOD" and "Wirefrarrre' modes, full clipping; pipelirte 
access; animation and model interaction supporl: and a 
"triad mouse" to map 2d mouse movemen! la 3d. 
3dPane provides inlegFatfon with the TCL and provides 
a view oricnialion controller SmartPane provides TCL 
offscreen image buffering, flicker free animalion, and 
QuickTime ftiovie recording SmartPane functions in 3d 
or 2d scenarios. All work wilh C++ compilers or ThinkC 6 
anrJ compile to PowerPC or 60K target mactiines. $192 

Spellswell 7 1,0,4 is an award-winning, 
comprehensive, practical spelling checker that works in 
batch mode Of within applications that Incorporate the 
Apple Events Word Services protocol [e g.. Eudora. 
WordPerfect. Communicate!, and Fair Witness). 
Speltswell 1 checks for spelling errors as well as common 
lypos like capitalization errors, spaces before puncluation, 
double double word errors, abbreviation errors, mixed 
case errors, extra spaces belween words, a/an before 
vowel/consonanl. etc... MacTecli orders include developer 
kit with Writeswell Jr., a sample Apple Events Word 
Services word-processor and ils source code, $74.95 

StoneTable Extra: Additional functions for 
StoneTable. Drag setected celfs within table or to other 
tables; oplionally add rows as part of drag, popup menus 
or check boxes In cells; variable width grid lines: 
move/drag/resizfi lahie in window, clipboard operations 
on multiple cells. Requires StnncTablc, (all prices per 
developer) $50 first cofnpiter. additional compilers $25 

StoneTable: A library replacing all fuficlions found in 
list manager plus: variable size columns/rows; rtiftcfent 
lent, size, style, forocolor, backcolor per cell, sort, resize, 
move, copy, hide columns/rows: edit cells/lilles in place; 
lilies lor columns/rows: multiple lines per cell: grid line 
paltern/color; greater than 32k data per table; up lo 32k 
text per (xjll; support for balloon help and binary cell data. 
Versions lor Think C, Think Pascal, MPW C. MPW 
Pascal. CodeWarrinr 6 C. (all prices per developer) $150 
first compiler, additional compilers $50. 

StoneTabfe and StoneTableExtra for 
PowerPC: Same functionahly as 68K libraries. 
Versions lor MPW C and CodeWarrlor 6 C. Musi have 
68K libraries, (all prices per developer) StorieTahle $100, 
StonftTabteFxtra $25, 


B-Tree HELPER’"" 2.2 is an inexpensive 
database engine for Macintosh programmers in 
C source code. B-lreo HELPER gels space in a file in 
contiguous fixed lengih blocks. It expands the file as 
necessary and conlracls tiles when possible. B-Tree 
HELPER inserts and deletes keys in one or more B-Trees 
If finds keys equal lo, less than, (tr greater ihan a given 
value in a few hundredths of a second. It finds lists of 
records whose keys are equal to. less tfsan, or greater than 
a given value or are in a range of values. $150 


SCRiFiiiNCr/SYSTEM ADMINISTIUTIOIN 


DataScript DataScript is probably tie quickest, easiest 
and most cost-effective way lo make your inlegialed 


Want more product info? E-mail us at proiluGtinfo@xplam.coiii 


MAIL ORDER STORE 


AppleScript solutions database aware-today. Quiirkest: 
It lakes just six lines of AppleScript to make new or 
existing scripted solutions database aware, and fetch data 
horn RDBM's such as Oracle, Sybase, DB2. or Intormix. 
Easiest: DalaScripfs .scripting terminology is easy lo 
loam, easy to use. and easy In remember ’Inside 
OateScript" contains lots ot easy to fotlow scripls to reuse 
in your own soiution. CnsI Effective: Because 
DataScript is so easy lo learn, and use you'll become 
productive very quickly, and once youTe ready to ship, 
you'll find our licensing schemes very attractive, 
$24900 

CLImate by Orchard Software Is a commarKt line 
inlertace teat lets you communicate with your Macintosh 
using English commands to create, delete, rename, and 
move files and folders. It can start applicalions, formal 
disks, restart your computer, etc. Climate supplements 
the Finder. !l includes a BASIC interpreter that fels you 
script youf MaanWi without AppfoScripL The interpreter 
includes advanced programming constructs; repeal loops, 
if/then/efse condilioiiafs. subroulino calls, etc... Climate 
implements wildcard characters, enahflng you lo work on 
groups of files. Use CLfimte Instead of MPW to manage 
your project. Climate is an application occupying 70K 
disk space. It comes bundled wiih sample programs and 
tell documentation. $59.95 

Cron Manager by Orchard Softvirare implements tee 
UHIX Cron facility. It can open any Macintosh file on a 
given date and lime. By creating an alias, renaming ii to 
tee date and time lo open, and moving it into the special 
Cron Events Folder, Cron Manager will open it. Cron 
Manager is a control panel that creafes tee special Cron 
Events Folder inside your System Folder. It is completely 
transparcnl to the user. It works like the xStarlop Items 
lolder. only smarter li works with any Macintosh file: it 
you can doublo-cllck lo start it. Cron Mafiager can open 
it. $25.95. Cron Manager bundled with Climate, $59.95. 

FaGeSpan""" v2 is an extensible Rapid Application 
Designer (RAD) that makes building applications quick 
and easy, II combines an interactive, visual interface 
design envlronmeni wilh Ihe objeet-ortented power of 
AppleScript or any OSA ianguage. Best of all, FaceSpan 
allows you lo integrate Ihe capabitily ot serlplable 
prngrann,s into your custom application. Your FaceSpan 
applirations can include any number of windows, dialogs, 
paleltes, and menus. In them, you can display scrolling 
lists, popup rrrenus. scrolling text, movies, multkolumn 
tables, picture,s, icons, buttons, and others. White no 
scripting is needed for standard behaviors, every Item 
may have ils own script. You can even program custom 
objecis using Pascal or C. Try tec perfect choice for MIS 
professionals, power users, consuflanls, and 
programmers 0 FaceSpanl Includes a royalty-free 
distribution license, lor unlimitetl runtime users, ot your 
FaceSpan-based applications. Also inclnried is a FREE 
UPGRADE to the nexl version for registered users, $199 

Rosanna™ Rosanna is a collection of utilities which 
offer the user complete control over raw data Users can 
sort files, extract selected records, summarize frequency 
counts, create sample hies, perform matching on multiple 
files, and reformat date to new specifications, all on the 
desktop, and even on files of a million records or more. 
The Rosanne Ulifilies also support AppleScript™, 
enabling the user to link several actions together to 
complete an entire process. The Rosanne UHtittes are 
recordable; users may perform a series of actions, and 
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using m AppleScript editor such as Scripter™. see their 
actions translated directly into AppleScript commands All 
of the utiiHies support multi-tasking and background 
processing. The rtosanne Litililies will assist you in 
picking your specifications, determining record length, 
creating output files and managing the storage of data 
Rosanne Utilities: Copy - duplicates an input file. 
Format creates an altered version of an input file, 
containing ailher subsets of the fields on the Input tile, or 
new fields. Seiect - creates a subset of the records on an 
input tile based on some selection criteria The Recnde 
opilon allows Ihe user to group data, or correci coding 
entries. Sort - orders an input file by a particular field or 
set ol fields. Match - joins toother two input files based 
on common values occurring in corffisponding iields or 
sets of fields Aggregale creates an output tile with 
summary levels. $595 

ScriptBase^ The Scripting Database Is a 

database for storing persistent objects to be made 
available for access to AppleScript, Apple's system-level 
user scripting language tor controlling applications on 
Macintosh* computers. Once installed, the database 
becomes part ol the AppleScript system, adding a host of 
commands to the basic AppleScript vocabulary. 
Retrieving the objects is simple using AppleScripTs 
natural'language syntax and strtJdure (Ejects stored and 
retrieved in Sertptflase can be accessible any time trom 
any script on the user's computer. These objects can be ol 
any type, including numbers, oharacler strings, lists, 
records, scripts, and references to disks, tiles, tolders, as 
well as abstract raw data, to name just a tew. ScriptBase 
can be used to maintain sysfem-wide settings, such as 
sets of preforences, paths to trequenlly-used files or 
folders. Complex insfatSations can be made easier by 
organizing data and scripts within the database's 
structure. $79 

Script Debugger by Late Night Software Ltd. is a 
powertut and flexible AppleScript authoring too!. Script 
Debugger makes it simple for novice and experienced 
script writers to get the most from AppleScript. The 
program's advanced debugging environment offers 
single-step script execution with breakpoinis. The 
Script Debugger dictiortary browser features a graphical 
view of objects provided by scriptable applications. 
With the program, you also receive the Late Night 
Software Scripting Additions, a coJlection of more than 
70 new AppIftSoripl commands, and Scheduler, a utifity 
that allows you to launch scripts at pre-determined 
times. $129 

Scripter^ fhe Aulhoring and Development 
Environment for AppleScript^*. Scriptcr, the Script 
Construction Set, is the foremost, comprehensive toot lor 
creating and debugging AppleScript scripts. Scripter is a 
shortcut to AppleScript's full capabilities, is both powerful 
and easy to use, and appeals equally to novices and 
experts. Scripter offers the largest collection of tools to 
answer Itie needs of every AppleScript user, containing 
over 35 features, including: Superior vocabulary 
access poinLand'CNck assembly of commands and 
object specifications: command window for 
experimentation Shoricuts and extended ediling 
capabilities extensive diag-amJ-drop, six-function 
find and-replace: navigation markers; script library 
collection facility; many other limesavers for faster 
scripting, interactive debugging - comprehensive 
variable watcher, expression evaluation, enhanced trace 


log, and real single step debuggingl Other features 
include: integration with FaceSpan and background 
processing. Unlike other scripting toots, which are either 
based on the original Script Editor concept, or are 
d^tgned to look more like traditional programming tools, 
the designers of Scripler understood from the outset that 
scripting is different from writing C code. Scripter will 
change the way yoti work with AppleScript. Main Event 
was the first to demonstrate ApploScript tools. Including 
debugging, and is in use by individuals and corporate 
users. From expert scripf design to user-friendly editing 
and implementation, Scripter is the natural companion to 
AppleScript ior all levels ol proficiency. $199 

TCP/IP Scripting Addition" is the latest version of 
an award-winning AppleScript scripting addition (tirsl 
place in the 1994 "Besl Hack" category in the Everyday 
AppleScript’ Programming Competition). This scripting 
addition (or osax) allows you to write scripts using 
MacTCP’ commar^ds in AppleScript’ Potential uses of 
this include sending e-mail or Hies through a script, 
checking it users are togged on (via Rnger), automating 
FTP, Gopher, NetNews. Telnet, and LPR, verilying links in 
IITML documents, and quickly writing many other TCP/IP 
Qlienl-server programs. Sample scripts are included 
already implementing many of these functions. When 
combined with FaceSpan. Ihe potential lor rapid 
implementatiorr of Inlemel c lien I-server applications is 
enormous, Ihe TCP/IP Scripting Addition works with 
AppleScript t.O or later and MacTCP 2,0,4 or later It is 
compatible with Opert Transporl’ The TCP/IP Scripting 
Addition can be used from Scripl Editor, HyperCard 2.2, 
MaePERL, FaceSpan and other Open Scripting 
Architeclure applicalions. 

See "http ://www mangotme-com/b iz/i nango/index. html' 
ior more details. $49 


MISCEUANEOilS 


nffni AppMaker makes it laster and easier to 
rniim uevelop the user inieriaco lor a Macintosh 
application Just point and ctick lo design your 
application, then AppMaker creales resources and 
genefates excellent source code. AppMaker supports 
most development environments including Mefrowerks, 
Symantec, or MPW, C, C++, or Pascal; procedural or 
object-oriented, using PowerPlant, TCL, or MacApp The 
generated code uses the Universal Headers to provide 
PowerMac compatibility. Begifiners use AppMaker to 
learn objecl-oriented and Macinlosh Toolbox 
programming techniques. Experts use it lo increase 
productivity It saves so much time it's like having your 
own assistant programmer working lor you. Includes one- 
year subscription on CD. $299 


■ BASIC for tho Newton is 

BASIC lor the Newton! Erom NS BASIC 

Corporation, it is a fully Interactive 

implementation of the BASIC programming 
BAiiu - no 

host is reqirired. It iricliKtes a full set ol (unctions and data 
types, hand-writlEn irput, windows, buttons and extensions to 
take advantage of the Newton environment. Applications can 
create files or access the built-in soups. Applic^ions can also 
access the serial port lor input and oulpuL Work directly on 
the Newfuri, (w Ihrough a connected !te/PC and keyboard. 
NS BASIC includes a 150 fseje pocket sized manual. ^ 


; Beekware by Metmwerks is here! 

: I In high school, they called you a 

computer geek. Now, they work at 
burger joints and wear polyester uniforms. And you doni 
Wear it to your favorite burger joint. $24.95 


Black Swiatshirts . $29.95 

Mousepad ... $3.95 

Geekware Shirt-Cotton .$24 95 

Geekwarc Shirt-Poly. ...$24 95 

Baseball Cap .... $16.95 

Inside CodeWarrior 6 Book.$34.95 

Blood , Sweat A Code Black Long Sleeve Shirt .. $14.95 
Cross Platform White Short Sleeve Shirt.SI 4.95 

Arnold Black Long Sleeve Shirt. .$14.95 



Guide Composer gives anyone the ability to create 
powerful Apple Guide help systems for any new or 
existing Macinlosh application Greal lor commercial 
developers, shareware developers, in-house developers, 
and ct)nsultanls, Guide Composer provides a WYSIWYG 
devetopment environment: Guide content is developed in 
Guide windows Design topics, phrases, and panels In 
the same formal as Ihe user will use them. Features are 
WYSIWYG interface. Topics, phrases, and hierarchicai 
phrases, Coach marks, Fully-Integrated with Apple’s 
Guide Maker {distributed with Guide Compos), compiles 
scripls automatically, PIGTs in Panels. Generated Guide 
scripts are modifiable, Compiled files are 100% Apple 
Guide-compalibleandroyally-free. Easy-to-use $99 

MacfiTen UNIX for Macinlosh and Power Macintosh 
MactiTen is a Berkeley UNIX thal runs on fhe Classic to 
ttie Power Mac. including PnwerBonks and Duos! So, in 
addition to all of the Macintosh applir^ations, you get a 
Mach-based UNIX with pre-emptive multitasking. 
MachTen extends the Macintn.sh operaliity system with 
UNIX frelworking and software development tools. The 
MacIntnsh/tiNIX integration is so strong that you can 
even use Macinlosh programs and utilities on UNIX data, 
and UNIX programs and utilifies on Macintosh files Full 
internel protocol support ensures fast, easy client and 
server NFS. e-mail, and file Iransler between the 
Macintosh and ail TCP-based enlilies on your network. 
Built-in intornel services rnciude domain name service, 
POP mail service, interncl routing. SUP & PPP, and Web 
service. Full X11R5 supporl witti Motil tor developtng X 
applications and a high periormance X server tor using 
your Mac as an X terminal MschTen Power UNIX 
$695. Personal MachTen (lor 68K Macs) $495 , 
ProtesHSional Mach fen (lor 68K Macs) $695 MachlErr X 



For complete product info see the MacTech Web" site at http;//www.mactecli.com. 
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TIPS & 
TIDBITS 


By Stew Sisak Contrihnting Editor 




Two S<11EEM MACSBlfG 


One feature of Macsl3ug that I like if> the ‘"swap" 
command, which lets you leave a second monitor display 
the debugger (and punches it out of the desktop). 

Then, if eat:h Debug^trO ends in ‘';g" you will get 
an onscreen kjg of dte last 10 or 15 breaks. I used this to 
track an elusive bug that would freeze my and tnish 
Macsbug memor^c.. 1 could see which breakpoint went 
last. 


Matt Slot 


Informant in the Mend Bar 


I do drivers, and you just plain c'an'i set a hreakpolm in ADB 
cojnjjletion routines (free/es the keyboard so MacsBug is 
worthless!). 

So I tlm)W' one of tltt^ routines lielow into the rouiine lo 
sec when a piece of cixlc gels excculed, 

What does it do? It "lights up" a bar (lengtli dependant on 
screen resolution) in the menu ban So if you l>otTt>ggle(300); 
you gel u fiashing short line in the menu bar. 

lU^atie thks oift of imfttnahft cof/rV <f ming /Aw art 

24 hit aylor screvns. Make sure that the mtue of where will not 
muse anything to lye wriUeu inky the alpha channel Ibwr best 
/xV is to test uHlb the screen ibai ’s only H hits deefy. -sgsl 


void DotOridon^ vhete) t 
long 'dot: 

dot = tloRg *HtMG<*tSr‘rn&aseO + where) ^ 
Mot [* -h 


I 


void aorOffUorif, wh^re) I 
long 'dot; 

dot = (long *) (LKGetScrnBaeeO + wher^s); 
'dot &= 0: 


void DotToggle(long whore) I 
long 'dot: 

dot “ (long *)(UKGetScrnfiasc0 + where); 
*dot -1; 


] 


Dai^ Fleck 


Tips & Tioiw is 


Oncl BriTEN TaiCF. Shy 


HGetSlate does not return a valid handle state when you pass it 
an empty handle (one whose master |X)inter is NULL). Instead, 
it returns an error ccxle, so liefore you call HGetState, he .sure to 
check that the handle isn't empty and cxecuie an alternate c:<xle 
patl i if it Ls. 

1 was bitten by this because I was u.stng HGetState to 
determine if a handle was to a a'istHJrcc, and tiie resource had 
heert fiurgcd. so HGetState relumed an error code insieatl of 
the liandle hags and 1 incrirrectly thought the handle wasn't to a 
resixirce. 

This is dtx'umented in Inside Macintosh. Memory, p. 1-61, 
but it Ixars some repeating. Remeber to check the error values 
returned by toollx)x calls. 

Fric Schlegel 


llfys & 1'idhiis continued on page 66 




\end usyonr tips ortm ll inslatl Et^niBetierlimError 


on y^yur machine! On the tgher hand, UKf might just 


pciy ym $25 for each tip urn use, or $50 far Tip of the 


Month, You can take your amard in goods, 


suhscriptions or US$. Afake sure any code compiles, 


and send iijys (and where to mail your udnnings) to 


our neu? Tips e*maiY address ai rips@m4Cte€h.a}m. 


Seepage tmyfor mtr other addresses, 
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He Should 
Have Used 


Why Hold Your Breath Waiting for a Client/Server Development Tool? 

- Get JAM* for the Macintosh Today! 


Firial!y.*ari Industrial strength client/server development toot is avaibbie for the 
Macintosh! JAM allows you to build client/server appiications on the Macintosh and 
depiqy them on more than 100 ptatforms and operating envinonmcnts including 
Macirrtosh, OS/2, Motif, Windows, DOS, VAX/VMS, and virtually every implementation 
of UNIX, And unlike the competitton’s runtime-only Mac ports, JAM for Macintosh 
provides a full application devetopment envinonment with true Mac look^and-feeL So 
don’t hold your breath any longer - get JAM for the Mac - and get the job done! 

JAM your Macintosh applications up and running with: 


/ Native Mode on 3oth 65K and 

Tower Macintosh 

/ Graphical Screen Editor / 

/ True Mac Look-and-Feel / 

y Full Cfevelopment Environment / 

- not just Runtime y 


Fortabiiity to 05/2. Motif 
Windows, and Character-mode 

Native D&M5 Support 
Automatic SQL Generation 
Flexibility to Add 3GL or 4GL Routines 
No Runtime Changes 


Call 1-600-45d-3313 

or E-mail: macjami^Jyacc.com for a free demonstration kit. 
For international inc^ulries call: 


1-212'267"7722 or FAX 1-212-606-6755 



OKAltL (BA) t I 111 ma . OEUMflltli (46) 13 31 &6 Tt * FittkAU^ fiBI) D l«a SIA i ffAMCE |13) 1 44 ■■ 45 44 * (SE«V4My (43) 40 Tfl 70 (3IB) 1 t41 111 

■HOin C11) aii H*l * 166451 tSTi) 5 SJt 33Jfl ' tT4(.¥ i|3t) 3 15 it «5 3 , i Ki 4tS3 ■ HUSSIA (7) 055 231 1414 ^ 54U0J 44*414 {tUt) 571 1741 

i»lH047^iei (05) 310 5331 . sLOveMi* <3461 d 1405 404 < SPAIH <}4> 1 404 Q43B ■ OTiiTJlW <44} 5 t6 14 10 « OWIfEitLAh^ (41} 11 401 0D41 * r>t*|L*N6 (H) t 413 3490 

THi Ni!VHP.41*1106 ai) 'TO 310 0114 » UMITED 4IN0FOM (44) 171 514 6660 


JAM ftum JYAa: 


JAW i4 * Ir^4iEiMrlt at JITA4C. liTiPiUinjirllli th* ptt9|}*rl:y 47 inatr 
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metrowerks 
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